Q:productID、SN、license、appuin、keyVersion从哪里来?

A:productID、appuin和keyVersion是您在小微官网注册设备时获取的,与此同时,您需要通过官网下载的工具生成一对秘钥(privateKey和publicKey),并在注册页面上传publicKey。SN是您的设备标识,由您自行定义,不含特殊字符即可。您的每台设备需要有唯一的SN,该SN对应的license可通过工具和privateKey生成,因此您需要妥善保管您的privateKey。

Q:我的设备有时候无法收到响应。

A:请排查以下问题,若仍然无法解决,请联系我们。

  • 首先需要确保设备登录成功,onLoginComplete无错误。
  • 确保您的网络通畅,无代理。
  • 确保您没有在多台设备上以相同的SN登录。
Q:接入过程中如何反馈问题?

A:在反馈问题的时候,请尽可能描述以下内容,将问题提交给对接人员。

  • 问题简述以及复现步骤
  • 问题发生的时间
  • 实际现象和期望现象
  • 复现频率
  • voiceID
  • SDK版本和平台
  • 本地日志,特别是偶现问题
  • 其它材料,如录制的视频
Q:程序遇到了crash,如何定位?

A:如果程序crash了在小微SDK的so中,可以提供堆栈的信息和日志,联系我们处理。

Q:为什么有时候在响应中能拿到responseData,有时候又没有?

A: responseData是一个optional的字段,在特定的技能下会有特定的内容,需要通过responseType进行区分。如天气技能,里面是最近的天气json信息,可以用于展示。

Q:小微的ASR识别效果不佳。

A:小微使用微信的ASR识别,准确率处于业界领先地位。目前只支持识别16位16kHz单声道的pcm数据,在识别过程中不会对其他声音进行处理,需要设备端在硬件和软件层自行进行降噪和回声消除。您可以将发送至小微的音频数据dump下来听一下,如果确定比较清晰,请联系我们处理。

Q:我的设备无法点播音乐。

A:音乐技能涉及到版权,即便是开发阶段,也需要联系商务开通。

Q:为什么我播放歌曲的时候只能听随心听的音乐?

A:播放音乐需要用户授权QQ音乐登录态,在没有完成小微绑定之前,无法进行指定点播。

Q:为什么我听音乐、FM、新闻等,听完几个就没有了?

A:为了增加响应速度以及避免回包过大,在资源点播时我们只会下发一部分,剩余的资源需要通过预拉取接口拉取。

Q:我点播的资源没有歌词和收藏信息。

A:歌词和收藏信息拉取较为耗时,需要通过查详情接口来拉取。

Q:为什么要事件上报?

A:为了支持小微平台对于请求的正常处理,我们需要设备端把一些关键事件的发生时间进行上报。如果没有上报关键事件,有些服务可能会受到影响,例如询问当前歌曲谁唱的。与此同时,在小微的APP和小程序上,会实时显示设备状态并控制设备,错误的状态会导致极差的用户体验。

Q:如何进行多轮对话?

A:多轮对话是由小微维护的,每次请求和响应您都会拿到一个上下文信息context,如果context中描述了上下文id,则表示进入了多轮对话,在下次请求时携带此id即可。