web通话demo接入说明
<p>[TOC]</p>
<h2>功能简介</h2>
<p>> 此文档用于描述web通话demo的接入过程，方便开发者快速对接web通话</p>
<h3>1、申请呼叫中心号</h3>
<p><img src="http://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-11/1668510125152/%E5%85%B3%E8%81%94.png" alt="" /></p>
<h3>2、关联服务中心号</h3>
<ul>
<li><a href="https://www.showdoc.com.cn/p/1dff5dad3ab635b548f60cb9d6ceb27b">https://www.showdoc.com.cn/p/1dff5dad3ab635b548f60cb9d6ceb27b</a></li>
</ul>
<h3>3、获取rtc_appid、rtc_appsecret</h3>
<ul>
<li>该参数在申请呼叫中心号审核通过后通过邮件发送，用于生成登录webSDK的rtctoken</li>
</ul>
<h3>4、webRTCSDK接入方法、demo、token生成算法等</h3>
<ul>
<li><code>该文档通过rtc_appid、rtc_appsecret、web端uid等参数生成token，用于建立RTC长连接</code></li>
<li><code>该链接不能直接下载文档，需要复制到浏览器方可下载文档</code></li>
<li><a href="http://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-9/1662536134867/webrtcsdk%E6%96%87%E6%A1%A36.0.zip">http://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-9/1662536134867/webrtcsdk%E6%96%87%E6%A1%A36.0.zip</a></li>
</ul>
<h3>5、生成登录RTC的token</h3>
<h4>5.1、开放平台获取</h4>
<ul>
<li><a href="https://dueros.baidu.com/business/emp/view/restdebug?pageType=getRtcToken&toolsType=restApi">https://dueros.baidu.com/business/emp/view/restdebug?pageType=getRtcToken&toolsType=restApi</a>
<img src="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-12/1671170755066/%E8%8E%B7%E5%8F%96token.png" alt="" /></li>
</ul>
<h4>5.2、通过demo获取</h4>
<ul>
<li><a href="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-12/1671170873787/token%E7%94%9F%E6%88%90%E7%AE%97%E6%B3%95.zip">https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-12/1671170873787/token%E7%94%9F%E6%88%90%E7%AE%97%E6%B3%95.zip</a></li>
</ul>
<h3>6、RTC长连接</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>获取方式</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>appid</td>
<td>邮箱返回的rtc_appid</td>
<td>小度分配给接入方的通话应用标识，标识一个音视频服务接入方</td>
</tr>
<tr>
<td>uid</td>
<td>开发者自定义英文字母或者数字字符串等</td>
<td>接入方为呼叫中心人员分配的唯一标识，可以用系统的用户id、手机号或其他用户唯一标识，需要保证在分配的appid下唯一</td>
</tr>
<tr>
<td>token</td>
<td>见第5步 “5、生成登录RTC的token”</td>
<td>用于初始化rtcsdk，因为rtc_appsecret需要保密（平台基于rtctoken鉴权，如果rtc_appsecret泄露会导致非法的音视频访问），需要由接入方云端提供接口给自己的web端获取，生成方法详见《token生成算法.zip》</td>
</tr>
<tr>
<td>name</td>
<td>用户任意填写</td>
<td></td>
</tr>
</tbody>
</table>
<p><img src="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-12/1671171076905/rtc%E7%99%BB%E5%BD%95.png" alt="" /></p>
<h3>7、同步联系人</h3>
<h4>7.1、开放平台同步</h4>
<ul>
<li><a href="https://dueros.baidu.com/business/emp/view/restdebug?pageType=getRtcToken&toolsType=restApi">https://dueros.baidu.com/business/emp/view/restdebug?pageType=getRtcToken&toolsType=restApi</a></li>
</ul>
<p><img src="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-12/1671169204830/%E5%90%8C%E6%AD%A5%E8%81%94%E7%B3%BB%E4%BA%BA.png" alt="" /></p>
<h4>7.2、接口同步</h4>
<ul>
<li><code>可以通过下面接口把呼叫中心号添加到小度通讯录</code></li>
<li>
<p><code>该接口需要加密，具体加密方法请参考demo</code></p>
</li>
<li><a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Felder%2Fcontact.md">https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Felder%2Fcontact.md</a></li>
</ul>
<h3>8、呼叫中心挂uid</h3>
<h4>8.1、开放平台挂载</h4>
<p><img src="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-12/1671172566379/%E6%8C%82%E8%BD%BDuid.png" alt="" /></p>
<h4>8.2、接口挂载</h4>
<ul>
<li><code>通过该接口将登录SDK的uid挂载到小度呼叫中心号上</code></li>
<li><code>此接口是覆盖逻辑，不支持查询和修改，请自行存储对应关系</code></li>
<li><code>如需增加和删除，需要重复调用接口即可</code></li>
<li>
<p><code>一个呼叫中心号最多挂载100个uid，小度来电随机呼叫一个空闲并在线的uid</code></p>
</li>
<li><a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Felder%2Fvirtual-uid.md">https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Felder%2Fvirtual-uid.md</a></li>
</ul>
<h3>9、获取设备信息</h3>
<h4>9.1、开放平台获取</h4>
<ul>
<li><a href="https://dueros.baidu.com/business/emp/view/restdebug?pageType=getDeviceInfo&toolsType=restApi">https://dueros.baidu.com/business/emp/view/restdebug?pageType=getDeviceInfo&toolsType=restApi</a></li>
</ul>
<p><img src="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-12/1671171405631/%E8%8E%B7%E5%8F%96%E8%AE%BE%E5%A4%87%E4%BF%A1%E6%81%AF.png" alt="" /></p>
<h4>9.2、接口获取</h4>
<ul>
<li><code>通过该接口，可以获取到小度号、小度uid、小度appid、在线状态等</code></li>
<li><code>如果获取到参数哦没有callAddress、callAppid、小度号，麻烦看下第二步“关联服务中心号”是否操作了</code></li>
<li><code>如果需要获取小度号，isDuerNumber字段传 &quot;false&quot;</code></li>
<li><code>如果需要获取小度callAddress、callAppid，isDuerNumber字段传 &quot;ture&quot;</code></li>
<li><code>获取的callAddress、callAppid需要解密后使用，具体解密方法demo有说明</code></li>
<li>
<p><code>callAddress为小度的uid，callAppid为小度的appid，用于web呼叫音箱参数</code></p>
</li>
<li><a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Felder%2Fget-device-info.md">https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Felder%2Fget-device-info.md</a></li>
</ul>
<h3>10、web呼叫音箱</h3>
<table>
<thead>
<tr>
<th>名称</th>
<th>获取方式</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>appid</td>
<td>通过 第9步 <strong> 9、获取设备信息</strong>获取</td>
<td>获取的callAppid参数解密后格式为“a9XXXX09”</td>
</tr>
<tr>
<td>uid</td>
<td>通过第9步 <strong> 9、获取设备信息</strong>获取</td>
<td>获取的callAddress参数解密后格式为“0036XXXXX41@HARD”</td>
</tr>
<tr>
<td>被叫姓名</td>
<td>自定义</td>
<td>仅作为呼叫展示，不是呼叫的必传参数</td>
</tr>
<tr>
<td>呼叫方式</td>
<td>视频/音频通话</td>
<td></td>
</tr>
</tbody>
</table>
<p><img src="https://dumi-dueros-bj-tob.cdn.bcebos.com/amis/2022-12/1671171748811/%E5%91%BC%E5%8F%AB.png" alt="" /></p>
<h3>11、音箱呼叫web</h3>
<p>保持RTC长连接登录状态下，对小度说“小度小度、呼叫养老管家”即可</p>