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

前提条件

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

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

使用步骤

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

步骤一：创建项目

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

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

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

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

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

   创建项目

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

   参数	描述
   项目名称/产品名称	项目名称在实例中唯一，支持中文、英文大小写、数字和下划线（_），长度不超过32个字符。
   项目配套产品来源	项目需要绑定具体的产品。 随项目创建一个新的产品：在物联网平台中自动创建一个与项目同名的产品。 通过现有产品创建项目：选择已创建的产品。 如果选择该项，建议使用已创建好的产品名称作为项目名称，方便匹配和识别。 创建完成后，项目会自动关联产品下设备。 说明 项目创建成功后，项目关联的产品下会自动添加千里传音语音播报服务所需的物模型功能。
   项目描述	用于备注项目背景信息，支持中文、英文大小写、数字和下划线（_），长度不超过500个字符，1个中文字符占2个字符位。

   关联项目

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

   参数	描述
   其它服务	目前仅支持使用寄雁传书智能小票打印服务。
   项目列表	选择需要关联的具体项目。

6. 单击确定。

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

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

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

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

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

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

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

步骤三：开发设备

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

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

步骤四：创建语料

1. 在项目管理页面，单击项目右侧的配置。

2. 在语料配置页签，单击新增语料。

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

   参数	描述
   语料类型	自定义语料：由用户自定义语音播报文本。 常用语料：由系统预置，包括数字、量词、货币单位、时间单位等常用语音播报文本。
   语料标识	与其他语料区别开来的标识。当设备调用多个语料进行组合播报时，通过该标识播报指定的语料。 当语料类型选择为自定义语料时，语料标识由用户自定义，支持英文大小写和数字，长度为1~32个字符，项目下保证唯一。 说明 建议将语料语义的拼音首字母设置为语料标识，例如：支付到账设置为ZFDZ，标识符不可使用{}””。 当语料类型选择为常用语料时，语料标识由系统自动生成。
   语料内容	需要播报的内容。 当语料类型选择为自定义语料时，需要填写语料内容。语料文本支持英文大小写、中文和空格，长度为1~100个字符，中文占2个字符。
   语料包类型	当语料类型选择为常用语料时，需要选择语料包类型。由系统预置常用的语料包，包括数字、量词、货币单位、时间单位等。
   语音场景	语料播报声音，由系统预设，例如标准女声、标准男声等。
   播报速度	语料播报速度。
   语料格式	语料音频的输出格式，仅支持WAV、MP3、AMR格式。
   声码推广	声码推广是在可听见的千里传音语料中叠加人耳不可见的营销音频内容，在手机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：设备的产品密钥。如下图所示：

相关操作

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