通过配置项目实现语音播报

千里传音语音播报服务通过项目管理播报设备和播报的语音文件,本文面向智能播报设备开发者,介绍如何快速将播报设备接入千里传音语音播报服务,获取来自服务的播报命令实现语音播报。

前提条件

  • 已开通千里传音语音播报服务。具体操作,请参见开通服务

  • 已购买语音播报需要的资源包。具体操作,请参见购买资源包

使用步骤

使用千里传音语音播报服务,需要在控制台创建项目和播报语料,然后将语料推送至设备中,再调用API使设备进行智能语音播报。

步骤

说明

步骤一:创建项目

项目主要用于资源隔离。千里传音以项目为维度提供服务,通过建立不同的项目来区分应用场景,实现多个项目之间设备和数据的隔离。

创建项目成功后,对应产品的物模型中会自动添加与千里传音语音播报服务相关的物模型功能定义,并完成物模型的发布。详细说明,请参见物模型通信

步骤二:获取设备鉴权信息

获取设备鉴权信息,用于设备端SDK开发。

步骤三:开发设备

在设备端集成千里传音功能。

步骤四:创建语料

在控制台创建播报语料。

步骤五:推送语料

语料创建完成后,将语料推送至设备中,以便后续进行语音播报。

步骤六:语音播报

通过调用千里传音语音播报服务的API完成智能语音播报。

步骤一:创建项目

  1. 登录物联网平台控制台,单击增值服务页签。

  2. 单击千里传音语音播报服务下的前往服务

  3. 在工作台左上角,选择目标实例。

  4. 在左侧导航栏中选择项目管理

  5. 项目管理页面,单击创建项目或者关联项目

    创建项目

    配置以下参数,创建一个全新的项目。

    参数

    描述

    项目名称/产品名称

    项目名称在实例中唯一,支持中文、英文大小写、数字和下划线(_),长度不超过32个字符。

    项目配套产品来源

    项目需要绑定具体的产品。

    • 随项目创建一个新的产品:在物联网平台中自动创建一个与项目同名的产品。

    • 通过现有产品创建项目:选择已创建的产品。

      如果选择该项,建议使用已创建好的产品名称作为项目名称,方便匹配和识别。

      创建完成后,项目会自动关联产品下设备。

    说明

    项目创建成功后,项目关联的产品下会自动添加千里传音语音播报服务所需的物模型功能。

    项目描述

    用于备注项目背景信息,支持中文、英文大小写、数字和下划线(_),长度不超过500个字符,1个中文字符占2个字符位。

    关联项目

    直接选择使用其他服务已有的项目。

    参数

    描述

    其它服务

    目前仅支持使用寄雁传书智能小票打印服务

    项目列表

    选择需要关联的具体项目。

  6. 单击确定

    创建项目或者关联项目成功后,会返回项目列表。

    在项目列表中,您可以查看项目ID,编辑、配置、停用项目等操作。

    • 查看项目ID:项目的唯一标识,在通过API进行服务调用时的重要参数。

    • 编辑项目:单击编辑,可以修改项目的描述,项目的名称和配套产品来源不支持修改。

    • 配置项目:单击配置,进入千里传音语音播报服务项目详情页面,配置播报设备、语料、推送任务等。

步骤二:添加设备获取鉴权信息

设备的鉴权信息后续需要使用,请复制至您本地并保存。具体操作,请参见获取鉴权信息

添加设备

若项目下产品还没有添加设备,您需先创建设备并添加设备到项目后,获取设备鉴权信息。

  1. 项目管理页面,单击目标项目右侧的配置

  2. 项目详情页面单击设备管理页签,然后单击添加设备

    创建设备
  3. 添加设备面板,可进行批量添加设备或单个创建设备:

    • 批量添加设备:

      1. 单击导入CSV添加设备,根据页面提示导入CSV文件。

        CSV文件模板说明,请参见批量创建设备

      2. 添加设备面板,单击确定

    • 单个添加设备:

      1. 单击去创建设备,跳转至物联网平台设备管理页面添加设备对话框。

      2. 设置设备名称,然后单击确认

        参数说明,请参见单个创建设备

      3. 返回千里传音控制台的添加设备面板,选中目标设备前的复选框,然后单击确定

  4. 添加设备确认对话框,确认可授权设备个数充足,然后单击确认

    如果可授权设备个数不足,需先进行购买。具体操作,请参见购买License

    重要

    添加设备会消耗License授权数量,请按需加入。设备成功加入项目后,License服务时间开始计算。

    image

获取鉴权信息

  1. 项目管理页面,单击目标项目右侧的配置

  2. 项目详情页面,单击设备管理页签,找到目标设备,单击鉴权信息,一键复制保存至您本地。鉴权信息

步骤三:开发设备

播报设备开发方法和详细说明,请参见设备接入说明

物联网平台提供千里传音C Link SDK,可助您快速集成并使用千里传音语音播报服务。详细内容,请参见C Link SDK说明

步骤四:创建语料

说明

添加设备成功后,才可创建所需的语料。

  1. 项目管理页面,单击项目右侧的配置

  2. 语料配置页签,单击新增语料

  3. 新增语料对话框,设置语料参数。

    参数

    描述

    语料类型

    • 自定义语料:由用户自定义语音播报文本。

    • 常用语料:由系统预置,包括数字、量词、货币单位、时间单位等常用语音播报文本。

    语料标识

    与其他语料区别开来的标识。当设备调用多个语料进行组合播报时,通过该标识播报指定的语料。

    • 语料类型选择为自定义语料时,语料标识由用户自定义,支持英文大小写和数字,长度为1~32个字符,项目下保证唯一。

      说明

      建议将语料语义的拼音首字母设置为语料标识,例如:支付到账设置为ZFDZ,标识符不可使用{}””

    • 语料类型选择为常用语料时,语料标识由系统自动生成。

    语料内容

    需要播报的内容。

    语料类型选择为自定义语料时,需要填写语料内容。语料文本支持英文大小写、中文和空格,长度为1~100个字符,中文占2个字符。

    语料包类型

    语料类型选择为常用语料时,需要选择语料包类型。由系统预置常用的语料包,包括数字、量词、货币单位、时间单位等。

    语音场景

    语料播报声音,由系统预设,例如标准女声、标准男声等。

    播报速度

    语料播报速度。

    语料格式

    语料音频的输出格式,仅支持WAVMP3AMR格式。

    声码推广

    声码推广是在可听见的千里传音语料中叠加人耳不可见的营销音频内容,在手机App中实现对不可听见音频的解码,从而获得与播报语音对应的动态营销内容。例如:商品连接,优惠活动连接等。

    开启该功能,需购买声码推广服务,即声码解析次数

    播报音量

    语料播报的音量大小,默认值为50%,设置范围:1~100%。

  4. 单击确定,生成语料。

    说明

    您还可以在生成语料前,单击试听,试听语料效果。

    在语料列表中,您可以在目标语料右侧操作列,单击对应操作:

    • 删除:从物联网平台的存储中删除语料。

    • 复制:快速创建配置相同,但播报内容不同的语料。

    • 编辑:修改语料的语音场景播报速度音量大小

    • 试听:播放语料,试听效果。

    • 下载:将语料下载至本地。

      您还可以选择多个语料进行批量下载,单击页面下方的批量下载

步骤五:推送语料

  1. 在目标语料右侧操作列,单击推送到设备

    您还可以选择多个语料进行批量推送,单击页面下方的批量推送

  2. 推送到设备对话框中,选择推送方式

    说明

    如果设备处于离线状态,依旧可以创建推送任务。

    推送方式

    描述

    单个设备

    在下拉列表中选择设备,将语料推送到该设备中。

    如果没有可选择的设备,单击创建设备进行创建。具体操作,请参见创建设备

    分组

    在下拉列表中选择分组,将语料推送到分组中的所有设备。

    如果没有可选择的分组,单击创建分组进行创建。具体操作,请参见创建分组

    全部设备

    将语料推送到项目中的所有设备。

    说明

    如果是关联项目,语料将同时推送至寄雁传书服务中的设备。

  3. 单击确定,完成创建语料推送任务。

  4. 单击推送任务看板页签,查看语料推送任务状态。

    说明

    设备只要在推送任务剩余时间内上线就可以收到任务的下发。但如果设备存储空间不足或推送超时(在剩余时间内,设备一直处于未激活或者离线状态),则推送任务会失败。

    推送
  5. (可选)单击设备管理页签,找到目标设备,单击右侧操作列的日志,跳转对应实例下的监控运维>日志服务页面,查看语料推送日志。

    语料推送包括如下过程:

    1. 向设备推送语料。

    2. 设备下载语料JSON文件。

    3. 设备下载语料。

    4. 设备回复语料下载完成。

    日志示例:

    [30.330][LK-0309] pub: /sys/a1C****R5/device/thing/service/SpeechPost
    
    [LK-030A] < 7B 22 6D 65 74 68 6F 64  22 3A 22 74 68 69 6E 67 | {"method":"thing
    [LK-030A] < 2E 73 65 72 76 69 63 65  2E 53 70 65 65 63 68 50 | .service.SpeechP
    [LK-030A] < 6F 73 74 22 2C 22 69 64  22 3A 22 31 31 31 37 30 | ost","id":"11170
    [LK-030A] < 37 38 31 32 34 22 2C 22  70 61 72 61 6D 73 22 3A | 78124","params":
    [LK-030A] < 7B 22 6A 6F 62 63 6F 64  65 22 3A 22 4B 5A 4E 56 | {"jobcode":"KZNV
    [LK-030A] < 65 76 6E 6A 4D 44 72 47  75 59 4B 6E 4C 68 32 4B | evnj*****nLh2K
    [LK-030A] < 61 65 52 57 4B 41 6D 52  63 79 65 37 5F 31 36 33 | aeRWKAmRcye7_163
    [LK-030A] < 32 39 30 31 31 37 34 30  30 30 22 2C 22 75 72 6C | 2901174000","url
    [LK-030A] < 22 3A 22 68 74 74 70 3A  2F 2F 73 70 65 65 63 68 | ":"http://speech
    [LK-030A] < 2D 73 6F 6C 75 74 69 6F  6E 2E 6F 73 73 2D 63 6E | -solution.oss-cn
    [LK-030A] < 36 50 34 37 26 53 69 67  6E 61 74 75 72 65 3D 73 | ****&Signature=s
    [LK-030A] < 36 57 78 63 70 33 43 65  25 32 42 36 49 72 49 62 | 6W*****e%2B6IrIb
    [LK-030A] < 37 5A 68 46 4D 7A 72 6C  43 76 42 49 25 33 44 22 | 7ZhF******BI%3D"
    [LK-030A] < 7D 2C 22 76 65 72 73 69  6F 6E 22 3A 22 31 2E 30 | },"version":"1.0
    [LK-030A] < 2E 30 22 7D                                      | .0"}            
    
    [51.420][LK-0309] pub: /sys/a1C****R5/device/thing/event/SpeechUpdateResponse/post_reply
    
    [LK-030A] < 7B 22 63 6F 64 65 22 3A  32 30 30 2C 22 64 61 74 | {"code":200,"dat
    [LK-030A] < 61 22 3A 7B 7D 2C 22 69  64 22 3A 22 31 22 2C 22 | a":{},"id":"1","
    [LK-030A] < 6D 65 73 73 61 67 65 22  3A 22 73 75 63 63 65 73 | message":"succes
    [LK-030A] < 73 22 2C 22 6D 65 74 68  6F 64 22 3A 22 74 68 69 | s","method":"thi
    [LK-030A] < 6E 67 2E 65 76 65 6E 74  2E 53 70 65 65 63 68 55 | ng.event.SpeechU
    [LK-030A] < 70 64 61 74 65 52 65 73  70 6F 6E 73 65 2E 70 6F | pdateResponse.po
    [LK-030A] < 73 74 22 2C 22 76 65 72  73 69 6F 6E 22 3A 22 31 | st","version":"1
    [LK-030A] < 2E 30 22 7D                                      | .0"}            

步骤六:语音播报

下面仅介绍API部分参数的获取方法,具体API调用,请参见:SpeechByCombination使用OpenAPI示例

  • CombinationList.N:语料标识。如下图所示:语料标识

  • DeviceName、ProductKey:设备的产品密钥。如下图所示:p

相关操作

千里传音语音播报服务还提供设备语料管理以及设备管理功能,方便您管理设备以及设备中的语料。

设备语料管理

  1. 项目详情页面中,单击设备语料管理页签,可以查看设备的DeviceNameProductKey剩余空间管理

  2. 单击右侧操作列的详情,可以查看设备状态和设备中的语料,还可以删除语料。

    您也可以调用物联网平台云端API DeleteDeviceSpeech,删除设备中的语料。

    删除

设备管理

  1. 项目详情页面中,单击设备管理页签。dd

  2. 设备列表中,单击添加设备

    支持单个和批量创建设备,具体操作,请参见上文的添加设备

    说明

    设备添加完成后,设备列表中显示新创建的设备。您可以查看设备的鉴权信息(ProductKey、DeviceName和DeviceSecret)和日志等。

  3. (可选)如果需要为设备授权License续费,在设备列表中,选择目标设备前的复选框,单击为选中设备绑定新授权,然后单击确认

    image
  4. 单击分组管理页签,然后单击创建分组,在创建分组对话框中输入分组名称分组描述,单击确定

    分组用于将同类设备进行分门别类,方便管理。

    • 分组名称:支持中文、日文、英文大小写、数字和下划线(_),长度为4~30个字符,一个中文和日文字符占2个字符位。

    • 分组描述:用于备注分组的背景信息。

  5. 单击分组名称右侧的详情分组详情页面,单击添加设备到分组,可以将设备添加到分组中。

    image

    设备添加到分组后,在推送语料时,可以将语料推送至分组中的设备。