常见问题

注意：目前这份文档是完全基于 dpl 2.0 协议和设计来实现的，我们十分推荐也希望能通过指定版本version: 2.0 来参考使用文档（1.0的因为协议设计等因素，目前并不能完全兼容），来使用 dpl 的最新和更多丰富、稳定的功能；

• 问题零

  • Q：dpl 模板不生效，报错；
  • A：注意看下您是否是希望参考这份文档来设计实现的dpl，如果是，请检查下对应 document 字段下的对应版本号是否为 2.0 版本：version: 2.0；

• 问题一

  • Q：dpl 模板可以正常渲染展现，但 command 都没反应；
  • A：注意，dpl 中收到的 ExecuteCommands 需要先经过 token 的验证匹配（匹配作为 RenderDocument 渲染指令下发的页面token），识别当前是否处在当前需要被执行的页面上（token 不匹配下发的 command 指令会被直接丢弃掉）；

• 问题二

  • Q：dpl 中，事件已经下发并确认对齐了 token，但是依然没有生效；
  • A：注意看下是否有主动下发 Listen 等指令，下发到设备端的指令（包含渲染、功能指令）是否可以执行，与当前设备端上的对话轮次有关，唤起设备听音会强制使端设备进入到下一轮次的对话中，默认情况下，基于上一轮次时上报的任何事件的返回，都会被端上认为是过时的响应而被丢弃掉，所以谨慎的避免使用会调起听音状态的指令与command指令同时下发的场景；

• 问题三

  • Q：在模拟器上得到的效果和实际设备上长得不一样；
  • A：模拟器（web模拟）和真机（Android底层）基于实现有所不同；我们在尽量的来减少它们之间的差异，同时也建议开发者同学在模拟器上可以先做前提的页面框架设计后，基于实际设备来进行精细的开发和最终的效果验证，ps: 模拟器也不支持执行功能指令；