使用方法

前提条件

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

使用步骤

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

步骤一：创建项目

1. 登录物联网平台控制台，在左侧导航栏选择增值服务。

2. 在增值服务页面，单击千里传音服务下的前往服务。

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

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

   • 创建项目：创建一个全新的项目。

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

   • 关联项目：直接使用其他服务已有的项目。

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

5. 单击确定，创建项目或者关联项目成功，返回项目列表。

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

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

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

   • 配置项目：单击配置，进入千里传音服务项目详情。

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

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

步骤三：开发设备

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

步骤四：创建语料

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

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

3. 在新增语料页面，设置语料参数。

   参数	描述
   语料类型	自定义语料：由用户自定义语音播报文本。 常用语料：由系统预置，包括数字、量词、货币单位、时间单位等常用语音播报文本。
   语料标识	与其他语料区别开来的标识。当设备调用多个语料进行组合播报时，通过该标识播报指定的语料。 当语料类型选择为自定义语料时，语料标识由用户自定义，支持英文大小写和数字，长度为1~32个字符，项目下保证唯一。 说明 建议将语料语义的拼音首字母设置为语料标识，例如：支付到账设置为ZFDZ，标识符不可使用{}””。 当语料类型选择为常用语料时，语料标识由系统自动生成。
   语料内容	需要播报的内容。 当语料类型选择为自定义语料时，需要填写语料内容。语料文本支持英文大小写、中文和空格，长度为1~100个字符，中文占2个字符。
   语料包类型	当语料类型选择为常用语料时，需要选择语料包类型。由系统预置常用的语料包，包括数字、量词、货币单位、时间单位等。
   语音场景	语料播报声音，由系统预设，例如标准女声、标准男声等。
   播报速度	语料播报速度。
   语料格式	语料音频的输出格式，仅支持WAV、MP3、AMR格式。
   播报音量	语料播报的音量大小，默认值为50%，设置范围：1~100%。

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

   说明

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

   在语料列表中，您可以对语料进行复制、编辑和下载等操作。

   • 复制语料

     在语料右侧，单击复制，可以快速创建配置相同，但播报内容不同的语料。

   • 编辑语料

     在语料右侧，单击编辑，可以修改语料的语音场景、播报速度和音量大小。

   • 下载语料

     在目标语料右侧，单击下载，可以将语料下载至本地。您还可以选择多个语料进行批量下载，单击页面下方的批量下载。

步骤五：推送语料

1. 在语料右侧，单击推送到设备。

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

2. 在推送到设备对话框中，选择推送方式。

   说明

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

   推送方式	描述
   单个设备	在下拉列表中选择设备，将语料推送到该设备中。 如果没有可选择的设备，单击创建设备进行创建。具体操作，请参见创建设备。
   分组	在下拉列表中选择分组，将语料推送到分组中的所有设备。 如果没有可选择的分组，单击创建分组进行创建。具体操作，请参见创建分组。
   全部设备	将语料推送到项目中的所有设备。 说明 如果是关联项目，语料将同时推送至寄雁传书服务中的设备。

3. 单击确定，创建语料推送任务。

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

   说明

   设备只要在推送任务剩余时间内上线就可以收到任务的下发。如果在剩余时间内，设备一直处于未激活或者离线状态，那么推送任务失败。

   您可以通过设备管理 > 日志查看语料推送日志。语料推送包括如下过程：

   日志示例：

   [30.330][LK-0309] pub: /sys/a1C****R5/ESP32_ADP_001/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 | 6P47&Signature=s
   [LK-030A] < 36 57 78 63 70 33 43 65  25 32 42 36 49 72 49 62 | 6Wxcp3Ce%2B6IrIb
   [LK-030A] < 37 5A 68 46 4D 7A 72 6C  43 76 42 49 25 33 44 22 | 7ZhFMzrlCvBI%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/a1*********/ESP32_ADP_001/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。

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

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

相关操作

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