中国电信智能音箱技能合作对接规范.docxVIP

中国电信智能音箱 技能合作对接规范 中国电信智慧家庭运营中心 2018-03 修订记录 版本编号 变化状态 变更说明 日期 变更人 V1.0.0 C 创建文档 2018-3-27 - V1.0.1 A 新增5.2.4、5.2.5场景相关接口 2018-5-22 - V1.0.2 M 5.2.1 5.2.2 5.2.5新增请求参数 2018-5-29 变化状态：[C] 创建、[A] 增加、[M] 修改、[D] 删除 概述 本文档针对中国电信标准版智能音箱产品引入外部生态合作的模式、技术方案及接口规范等内容进行说明，以快速丰富中国电信智能音箱的技能服务。 本规范由中国电信智慧家庭运营中心制订并更新。 合作模式 由外部合作方提供音箱硬件及语音云，并根据电信要求进行软件改造，将天翼高清、智能家居等电信特色技能接入合作方生态，当涉及天翼高清、智能家居业务时，调用电信音箱平台提供的接口，实现智能音箱对天翼高清、智能家居的控制。手机端须使用智慧家庭统一APP对音箱进行配网、相关技能的配置等。 示意图如下： 实现场景说明 3.1 合作方音箱手机端SDK集成 1）合作方音箱厂家提供音箱管理手机端SDK，中国电信智慧家庭统一客户端APP进行集成。 2）智慧家庭统一客户端APP通过合作方提供的SDK完成对合作方音箱的网络配置、功能管理等。 3）合作方音箱SDK需要将音箱的唯一设备识别号（如SN）传递给智慧家庭统一客户端APP，智慧家庭统一客户端APP将合作方音箱的设备识别号保存在电信的系统中。 3.2 合作方音箱控制智能家居及iTV场景 合作方音箱通过调用中国电信智能音箱平台接口，实现对中国电信智能家居及iTV机顶盒的控制。 中国电信智能音箱平台屏蔽各省的天翼高清平台和智能家居平台的差异性，对合作伙伴输出统一接口。 基本流程如下，其中完成1-4，音箱设备与电信统一账号建立绑定关系后，即可通过语音控制音箱自带的技能及所绑定的智能家居设备，但若要实现对iTV的控制，用户须通过智慧家庭统一客户端APP完成音箱与机顶盒的绑定，该绑定操作由电信侧完成，无须合作方实现。 1）用户通过账号登录智慧家庭统一客户端，选择进入合作方音箱配置页面； 2）智慧家庭统一客户端调用合作方音箱手机端SDK的获取音箱信息接口监听者； 3）智慧家庭统一客户端调用合作方音箱手机端SDK的配网接口完成合作方音箱的配网。 4）配网成功后合作方音箱手机端SDK返回音箱设备信息给智慧家庭统一客户端，统一客户端完成音箱设备和中国电信智能音箱平台账号的绑定；统一客户端将绑定结果通知合作方音箱手机端SDK，合作方音箱平台标识该音箱为中国电信定制版，后续关于智能家居、天翼高清视频相关业务指令都转到中国电信智能音箱平台； 5）用户通过语音输入控制指令给合作方音箱，合作方音箱拿到语义处理结果后根据具体语义选择调用中国电信智能音箱平台的智能设备控制接口和iTV控制接口; 6）中国电信智能音箱平台返回处理结果给合作方音箱; 7）合作方音箱根据处理结果，给用户相应的反馈提示。 软件改造要求 4.1对合作方语音平台的要求 1）能够根据业务进行语义调度，即要求合作方平台能够识别出当前用户操控的是天翼高清、智能家居，还是自有业务生态。 2）由电信提供一套针对天翼高清、智能家居的语义规则，需合作方在自身平台配合实现，保证各个合作方对于智能家居、天翼高清的语义规则一致，即同样的语音执行的操作相同。 4.2对合作方智能音箱的要求 1）合作方所提供的智能音箱，如天猫精灵、叮咚、小爱同学等需通过智慧家庭统一APP进行配网及管理，由合作方提供智能音箱相关的SDK，供电信智慧家庭统一APP集成或调用，以完成配网、获取技能列表、上报用户信息等功能。 2）能够调用音箱平台接口，将语义指令下发至音箱平台。 接口说明 合作方智能音箱要实现对中国电信智能家居及iTV的控制，需要集成电信平台提供的相关接口，将相关业务处理请求转给各个业务平台，具体接口规范如下。 5.1合作方音箱手机端SDK提供的接口 5.1.1打开合作方音箱配网界面接口 接口用途： 电信智慧家庭统一客户端通过调用该接口打开合作方音箱SDK提供的配网页面。 接口定义： void startNetConfig(); 参数说明：无 5.1.2获取合作方音箱设备信息接口 接口用途： 合作方音箱SDK通过该接口将音箱设备信息、在线状态回调给电信智慧家庭统一客户端，用于相关业务处理。 接口定义： void setDeviceListener(DeviceListener listener); 参数说明： DeviceListener 合作方音箱设备信息回调对象，具体接口如下。 音箱设备信息回调接口 接口说明：合作方音箱配网成功后回调该接口，传递音箱设备信息给智慧家庭统一客户端