1.1.1. 当发生了错误

若琪会使用 Skill 的错误消息告知用户发生了什么错误,并如何解决该错误;如果 Skill 没有返回标准的错误格式,若琪将无法告知用户如何解决问题。

{
  "header": {
    "messageId": "789-123",
    "namespace": "Rokid",
    "name": "ErrorResponse",
    "payloadVersion": "v1",
  },
  "payload": {
    "name": "E_INTERNAL_ERROR",
    "vendorCode": "厂家自有错误码",
    "message": "Skill 对发生的错误的详细描述,若琪不会将这个消息展现给用户",
    "debugInfo": "something for debug",
  }
}

Error Payload

字段名 类型 描述
name string 若琪提供的枚举错误码
vendorCode string 厂家自有错误码
message string Skill 对发生的错误的详细描述,若琪不会将这个消息展现给用户
debugInfo string 用于调试的必要信息,用于协助问题定位

Error Codes 错误码

ErrorCode 描述
E_AUTHORIZATION_EXPIRED 授权过期,应该尽快刷新
E_INVALID_AUTHORIZATION 授权非法,并且不应该继续使用、刷新
E_NO_SUCH_ENDPOINT 终端不存在
E_NOT_SUPPORTED_DIRECTIVE Skill 不支持当前命令请求
E_VALUE_OUT_OF_RANGE 命令的值超出了阈值
E_ENDPOINT_BUSY 终端正在处理请求(不一定是来自若琪的命令请求),无法处理当前命令请求
E_CHANNEL_NOT_FOUND 没有对应的频道
E_INTERNAL_ERROR 通用错误,当错误不是上述任一错误时,使用该错误码
E_ENDPOINT_UNBOUND 设备被解绑,无法控制。建议用户:重新对该设备配网
E_ENDPOINT_NEEDS_UPGRADE 设备固件需要升级
E_ENDPOINT_UNREACHABLE 无法访问到终端
E_ENDPOINT_INITIATING 终端正在初始化
E_GATEWAY_UNREACHABLE 无法访问到终端网关
E_SERVER_UNREACHABLE 无法访问到终端服务器
MediaErrorCode 描述
E_MEDIA_RESOURCE_NOT_FOUND 找不到相关歌曲
E_MEDIA_FAVORITE_NOT_FOUND 未找到收藏歌曲
E_MEDIA_NO_PREV 已经是第一首了
E_MEDIA_NO_NEXT 已经是最后一首了

results matching ""

    No results matching ""