# 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即可。