使用共享设备播报分享语料

前提条件

分享方已创建项目并添加播报设备。具体操作，请参见步骤一：创建项目、步骤二：添加设备获取鉴权信息和步骤三：开发设备。

背景信息

使用共享语料功能可以将自身的播报设备，全部或部分共享给有语音营销投放需求的用户，来进行共享语料播报，从而让播报设备创造出更高的价值。

开启分享语料

分享方和被分享方需要都开启分享语料的功能。

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

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

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

4. 在左侧导航栏中选择分享语料管理。

5. 全部选中分享语料协议前的复选框，单击开通。

   在左侧导航栏单击分享语料管理，进入播报语料分享协议页面。三个复选框分别为：允许被分享方获得设备的ProductKey和DeviceName信息、允许被分享方创建共享语料、允许被分享方获取每月共享语料播放次数和组合数据。

配置分享任务

分享方创建分享任务

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

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

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

4. 在左侧导航栏中选择分享语料管理。

5. 在分享任务页签，单击新增任务。

6. 在新增任务对话框中，输入任务名称，单击确认。

   任务名称支持中文、英文字母、数字、下划线（_）、短划线（-），长度限制为1~64个字符，1个中文算2个字符。

   分享任务创建成功后，显示当前状态为待分享。此时，您可单击对应操作列的编辑，修改任务名称。

   此外，操作 列还提供 详情 和 分享审批 链接。

7. 在任务列表中，找到对应任务的分享码，将该分享码发送给被分享方。

被分享方加入分享任务

被分享方需要通过分享码加入对应分享任务。

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

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

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

4. 在左侧导航栏中选择分享给我的，然后单击添加分享任务。

5. 在弹出对话框输入分享码，单击确认。

   分享码需从分享方获取。分享任务添加成功后，显示当前状态为待审核。

   等待分享方审核同意后，任务状态显示为分享中。

分享方审核被分享方加入分享任务

被分享方通过分享码加入分享任务后，需要分享方审核同意。

1. 分享方返回千里传音语音播报服务控制台的分享语料管理页面。

2. 在任务列表中，找到待审核的目标任务，单击分享审批。

3. 在确认分享对话框，全部选中分享协议复选框，单击同意。

   分享协议复选框包括：允许被分享方获得设备的ProductKey和DeviceName信息、允许被分享方创建共享语料、允许被分享方获取每月共享语料播放次数和组合数据。

   分享方同意后，分享任务的当前状态显示为分享中。

分享方添加共享设备

分享方审核分享任务分享通过后，需将用于共享的播报设备加入到分享任务中。

1. 在任务列表中，找到目标分享任务，单击操作列的详情。

2. 在任务详情页面，单击分享设备页签。

3. 单击添加设备，在当前实例下的千里传音项目列表，找目标项目。

4. 在项目右侧操作列，选择以下操作，添加目标设备。

   • 单击全部添加，然后在弹出对话框中单击确认，添加对应项目下全部播报设备。

   • 单击选择设备，在选择设备对话框，可通过以下方式，添加设备。

     对话框顶部提供搜索框，可输入 DeviceName 搜索设备。单击 导入进度哪里看，可在 任务详情 > 分享设备 页面的批量导入看板中查看导入进度。

     • 选中设备选中目标设备前复选框，单击确定。

     • 单击通过文件添加，在导入设备文件对话框，单击导入CSV添加设备，根据页面提示上传文件，单击确定。

       您可单击点击下载，下载文件模板，填入项目下已有设备信息（ProductKey和DeviceName）。

被分享方添加共享语料

1. 分享方返回千里传音语音播报服务控制台的分享给我的页面。

2. 在任务列表中，找到对应任务，单击操作列的详情。

3. 在任务详情页面，单击添加共享语料。

   您可在任务详情页面查看分享方信息。

4. 在新增语料对话框，配置语料信息，然后单击确定。

   参数说明，请参见创建语料。

   添加共享语料成功后，共享审核状态为待审核。此时，单击右侧操作列的编辑，可修改语料信息。

   等待分享方审核同意后，共享审核状态为已审核。此时，被分享方无法再编辑共享语料信息。

   如果分享方审核拒绝，被分享方可单击右侧操作列的编辑，修改语料信息后，等待分享方审核。

分享方审核共享语料

被分享方添加共享语料后，需要分享方审核同意。

1. 分享方返回分享任务的任务详情页面。

2. 在分享语料页签，单击对应语料右侧操作列的试听。

3. 试听后，单击对应语料右侧操作列的待审批。

4. 在语料审核对话框，查看语料信息后，进行审核。

   语料信息包括语料内容、语音场景、播报速度、语料格式（WAV、MP3、AMR）和播放音量。

   • 单击同意，共享语料的当前状态显示为已审核。被分享方无法再编辑对应语料信息。

     说明

     审核通过的共享语料会被推送至当前分享任务的所有共享设备中。

   • 单击拒绝，共享语料的当前状态显示为已拒绝。被分享方可修改对应语料信息后，等待分享方再次审核。

     被分享方可单击 操作 列的 待审批 按钮重新提交审核。

分享方查看推送任务看板

分享方可查看当前分享任务下，共享语料和共享设备的推送详情。

1. 分享方在任务详情页面，单击推送任务看板页签。

   推送任务看板页面展示任务列表，包含任务创建时间、推送模式、完成比例、剩余时间和操作列。页面顶部可通过全部模式下拉框按推送模式筛选任务，每条任务的操作列提供详情链接。

2. 单击目标任务右侧操作列的详情，可查看当前任务的完成状态。

3. 单击共享设备右侧操作列的详情，可查看推送到设备的共享语料信息。

   推送详情页面顶部展示 目标设备总数、目标成功数、目标失败数、进行中 四项统计指标。下方设备列表包含 DeviceName、完成状态、错误码、最后更新 列。单击某台设备后，右侧弹出 语料详情 面板，展示该设备关联的 序号 和 语料标识。

共享播报

在完成分享任务的所有配置后，分享方需要按照已配置的播报方式，帮助被分享方在共享设备中播报共享语料。

播放共享语料，需使用千里传音语音播报服务提供的共享组合播报API完成，具体API调用方法，请参见ShareSpeechByCombination和使用OpenAPI示例。

查看播报看板

分享方可通过播报看板，便捷地查看整体的播放效果。

1. 分享方返回千里传音语音播报服务控制台的分享语料管理页面。

2. 单击播报看板页签，查看分享任务的播报信息和效果。

   播报看板页面展示以下统计信息：共享设备总数和本月新增共享设备；播报设备统计区域包含有播报记录设备数、本月有播报记录设备数和昨日有播报记录设备数，每项均可单击下载CSV导出数据；单日统计区域包含单日播报总次数、单日播报成功率和播报失败原因分布环形图（失败原因包括重复播报、语料不存在、平台内部错误、设备超时、设备离线），可单击导出详情获取明细。