书本语言切换方案
<h2>问题</h2>
<p>一些书籍（特别是绘本），在市场上常常存在多个不同语言的版本。例如著名绘本《我爸爸》就有《我爸爸（中文）》和《我爸爸（英文）》两个版本，它们的封面极其相似，无法通过图像算法区分。因此，当用户阅读这些书籍时，播放的资源有可能与其使用的书籍版本不匹配。</p>
<p>对上述问题，我们的解决方案是让用户自行为书籍选择正确的资源。下面以家长端为例，我们将说明如何在家长端实现让用户选择书籍资源（语言）的功能。</p>
<h2>方案</h2>
<p>为解决上述问题，内容制作和需要技术开发两个层面工作的配合。
其中技术层面，又分为家长端切换资源和儿童端切换资源</p>
<h3>1. 内容制作层面</h3>
<h4>必要条件</h4>
<h5>1. 必须满足，创建的应用关联2个以上资源库（如果关联玩瞳库也计算在内）</h5>
<p>例：（见下文和下图）</p>
<pre><code> 创建中文版本资源库，用于存放中文版资源
创建英文版本资源库，用于存放英文版资源</code></pre>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/ca22945bf7575ad315339f161ad4fd73?showdoc=.jpg" alt="" /></p>
<h6>创建资源库流程，请参考资源库管理文档</h6>
<p><a href="https://www.showdoc.cc/bailubtr?page_id=2363056369592827">https://www.showdoc.cc/bailubtr?page_id=2363056369592827</a></p>
<h5>2. 必须满足，一本书需要同时在2个以上资源库中有资源</h5>
<p>例如：《我爸爸》这本书在中文资源库中有资源，同时在英文资源库中也有资源
<strong>注意：如果关联玩瞳大库，此玩瞳资源也计算在内</strong></p>
<h4>如何创建书本资源时，指定资源库</h4>
<h6>指定资源库</h6>
<p>注意1：在制作领读或点读资源流程中，领书步骤中文库和英文库，领的书必须是同一本（例如，《我爸爸》在中文库和英文库领书时，必须是同一本）
注意2：在制作领读或点读资源流程中，领书步骤需要指定到对应的资源库（如下图）</p>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/0a5c525494a23f3290cea464d5d63d73?showdoc=.jpg" alt="" /></p>
<h2>移动资源</h2>
<p>为什么需要移动资源？
因为当前某本书制作时资源库选错时，可以通过移动资源调整资源库</p>
<h6>移动资源操作流程</h6>
<p>1.打开内容管理
2.选择资源库级搜索书名（本书当前所在资源库）
3.选择书本进行移动
4.选择移动到的资源库
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/e036e9484e1682f12a97a5dc181156ea?showdoc=.jpg" alt="" /></p>
<h3>2. 技术开发层面</h3>
<h4>需要使用的API</h4>
<ul>
<li>获取一本书的资源id列表（<a href="https://www.showdoc.cc/visiontalk?page_id=3017144234130237">点击查看API文档</a>）</li>
<li>为一个openId指定一本书使用的资源（<a href="https://www.showdoc.cc/visiontalk?page_id=3017151223213989">点击查看API文档</a>）</li>
</ul>
<h4>儿童端实现方式举例（实际实现效果客户可自行定义）</h4>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/a351b655969c6870548928cef8a2a11e?showdoc=.jpg" alt="" /></p>
<h4>家长端实现举例</h4>
<p>注：玩瞳公版家长端未实现此功能，合作商可利用上述API自行开发。</p>
<ol>
<li>
<p>用户进入家长端阅读历史列表
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/577b0c06493392e5b1cfa6d03a319c33?showdoc=.jpg" alt="" /></p>
</li>
<li>
<p>用户在列表中打开一本书的详情页面
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/02fe72b21af386e6057bd15414162117?showdoc=.jpg" alt="" /></p>
</li>
<li>
<p>用户点击“切换音频版本”按钮
点击后，可调用“<a href="https://www.showdoc.cc/visiontalk?page_id=3017144234130237">获取一本书的资源id列表 API</a> ”来展示书本的资源列表。返回的资源列表中的第一项为该书当前使用的资源。
<img src="https://www.showdoc.cc/server/api/common/visitfile/sign/31b889a7db5c1092f01cde3e0bba35e0?showdoc=.jpg" alt="" /></p>
</li>
<li>用户选定资源
上图中，用户选定资源时，可调用“<a href="https://www.showdoc.cc/visiontalk?page_id=3017151223213989">为一个openId指定一本书使用的资源</a> API”来实现资源的切换。</li>
<li>完成上述一系列操作后，设备再次识别绘本时，将播放用户选定的资源。</li>
</ol>
<p>文档维护人：卢延青
如有疑问请加微信号：w11880927（秦永川，加微信时请备注下“文档咨询”）</p>