扬声器_v1.0

• SetVolume 指令
  • 消息样式
• AdjustVolume 指令
  • 消息样式
• VolumeChanged 事件
  • 消息样式
• SetMute 指令
  • 消息样式
• MuteChanged 事件
  • 消息样式

扬声器接口包含调整音量、设置/取消静音的指令和事件。

SetVolume 指令

设备端接收该指令后，应该按要求将设备音量设为一个最大音量的一定百分比。

消息样式

{
  "directive": {
    "header": {
      "namespace": "Speaker",
      "name": "SetVolume",
      "messageId": "e52e7a4c...",
      "dialogRequestId": "49687be..."
    },
    "payload": {
      "volume": 78
    }
  }
}

Header参数

参数名	说明	类型
messageId	代表一条message的唯一ID	String
dialogRequestId	客户端必须为recognize请求创建的唯一ID，此参数用于关联响应特定Recognize事件发送的指令	String

Payload参数

参数名	说明	类型	必须出现
volume	将要设置的音量的绝对数值百分比 取值： 0到100之间	Long	是

AdjustVolume 指令

设备端接收该指令后，应该按要求将设备音量做一个最大音量的-100%到100%之间的相对调整。

消息样式

{
  "directive": {
    "header": {
      "namespace": "Speaker",
      "name": "AdjustVolume",
      "messageId": "e52e7a4c...",
      "dialogRequestId": "49687be..."
    },
    "payload": {
      "volume": 10
    }
  }
}

Header参数

参数名	说明	类型
messageId	代表一条message的唯一ID	String
dialogRequestId	客户端必须为recognize请求创建的唯一ID，此参数用于关联响应特定Recognize事件发送的指令	String

Payload参数

参数名	说明	类型	必须出现
volume	将要设置的音量的相对数值，在当前音量的基础上增大或减小 取值： -100到100之间	Long	是

VolumeChanged 事件

以下情况设备端必须上报该事件至服务端：

• 收到SetVolume或AdjustVolume指令并在设备端完成了音量的设置/调整。
• 设备本地通过按键完成了音量的调整。

注意

volume必须是0到100之间的值。若本地的音量是0到10，则上传至服务端时需要换算成0-100的数值。

消息样式

{
  "event": {
    "header": {
      "namespace": "Speaker",
      "name": "VolumeChanged",
      "messageId": "e52e7a4c..."
    },
    "payload": {
      "volume": 10,
      "muted": false
    }
  }
}

Header参数

参数名	说明	类型
messageId	代表一条message的唯一ID	String

Payload参数

参数名	说明	类型	必须出现
volume	设备音量的绝对数值。 取值： 0到100之间	Long	是
mute	静音的布尔值，静音取值TRUE，取消静音取值FALSE	Boolean	是

SetMute 指令

设备端接收该指令后，应该按要求将设备设为静音/非静音

消息样式

{
  "directive": {
    "header": {
      "namespace": "Speaker",
      "name": "SetMute",
      "messageId": "e52e7a4c...",
      "dialogRequestId": "49687be..."
    },
    "payload": {
      "mute": false
    }
  }
}

Header参数

参数名	说明	类型
messageId	代表一条message的唯一ID	String
dialogRequestId	客户端必须为recognize请求创建的唯一ID，此参数用于关联响应特定Recognize事件发送的指令	String

Payload参数

参数名	说明	类型	必须出现
mute	静音的布尔值，静音取值TRUE，取消静音取值FALSE	Boolean	是

MuteChanged 事件

以下情况设备端必须上报该事件至服务端：

• 收到SetMute指令并在设备端完成了静音/非静音的设置。
• 设备本地通过按键完成了静音/非静音的设置。

消息样式

{
  "event": {
    "header": {
      "namespace": "Speaker",
      "name": "MuteChanged",
      "messageId": "e52e7a4c..."
    },
    "payload": {
      "volume": 78,
      "muted": false
    }
  }
}

Header参数

参数名	说明	类型
messageId	代表一条message的唯一ID	String

Payload参数

参数名	说明	类型	必须出现
volume	设备音量的绝对数值。 取值： 0到100之间	Long	是
mute	静音的布尔值，静音取值TRUE，取消静音取值FALSE	Boolean	是