1 有声垂类业务说明

1.1 业务简介

有声读物的服务合作商通过接入华为快服务智慧平台可以向华为的泛终端（手机，平板，音箱等等）用户提供有声读物的搜索，收听等服务。

1.2 用例场景

对于华为泛终端的用户来说，根据各种终端交互方式的不同，有声服务的提供也对应着不同的表现样式。比如在手机界面上，用户可能会通过查询，选择查询结果，点击收听来分步进行操作；而对于音箱、语音助手等语音场景，用户可能就会通过“一步到位”的方式来使用有声服务，比如通过“小艺小艺，播放孙皓晖的大秦帝国”命令来实现指定内容的直接播放。
总的来说，当前两种比较典型的终端交互方式用例如下图：

1.3 业务流程

为了实现服务的统一分发，我们约定华为的各类型的终端通过接入快服务智慧平台使用有声服务的功能要分为三个具体意图，分别是查询专辑，获取专辑节目列表和获取节目资源URL。这三个意图由终端按照顺序触发来实现整个有声业务的闭环。更直观的，业务的详细流程可以通过下图说明：

2．接入方式说明

2.1　术语约束

根据合作商的各自的数据资源特点和开发能力现状，快服务智慧平台的有声服务提供了几种接入方式供合作商选择。为了后面描述方便，在此我们先约定一个术语：
元数据：有声读物节目资源数据，包含可供查询的专辑名称和ID，节目名称和ID以及专辑节目之间准确的映射关系。数据本身具有准确搜索的能力，快服务智慧平台可以由此数据构建有声读物的所有业务功能，直接为泛终端用户提供完整的服务。

2.2　元数据定期线上同步方式

此方式适用于合作商能够提供的有声资源中专辑数大于500条且节目数大于1000条，或者有声读物资源内容为畅销书，流行节目等等，元数据会经常发生变更（不包含资源URL因时效性发生变更）的情况。
该方式下，合作商需要提供一个接口供快服务智慧平台请求同步结构化元数据，快服务智慧平台这边会启动一个定时任务来周期性同步合作商提供的结构化元数据。据此，快服务智慧平台自己可以充当有声内容的元数据提供者，从而为合作商构建有声服务能力。元数据同步接口的请求和响应参数格式请参考3.1节。
若合作商有声资源中URL具有时效性，有超时过期的机制，则需要额外提供一个获取资源URL的查询接口，该接口请参考3.4节。

2.3　元数据线下提供方式

此方式适用于合作商能够提供结构化元数据，但是有声资源不满足2.2中的数目要求，并且有声读物资源内容不会经常发生变更（不包含资源URL因时效性变更）的情况。
该方式下，合作商只需要定期将结构化元数据以Excel文件形式线下向HAG提供即可。Excel的数据格式模板请联系华为快服务智慧平台工程师获取。
同样，若合作商有声资源中URL具有时效性，有超时过期的机制，则需要额外提供一个获取资源URL的查询接口，该接口请参考3.4节。

2.4　仅提供完整查询接口方式

此方式适用于合作商无法提供元数据给快服务智慧平台。
该方式下，合作商需要开发查询专辑、获取专辑节目列表、获取节目资源URL三个查询接口。接口详情请参考第3章后3节。

2.5　三种接入方式横向对比

3．接口和参数说明

1. 内容数据定时同步接口
2. 查询接口(apiKey=audio-search)
3. 专辑节目列表接口(apiKey=audio-albumDetail)
4. 节目资源URL(apiKey=audio-queryContentUrl)