扬声器控制

摘要

本接口定义扬声器控制相关的功能，如音量的调节、静音设置等等。

SetVolume指令

设置音量，给绝对音量值，音量绝对值在0到100之间。

消息样例

"directive": {
    "header": {
        "namespace": "ai.dueros.device_interface.speaker_controller",
        "name": "SetVolume",
        "messageId": "{{STRING}}",
        "dialogRequestId": "{{STRING}}"
    },
    "payload": {
        "volume": {{LONG}}
    }
}

Payload参数说明

• volume
  • 要设置的音量绝对值，[0, 100]

AdjustVolume指令

设置音量，给相对变化值。

消息样例

"directive": {
    "header": {
        "namespace": "ai.dueros.device_interface.speaker_controller",
        "name": "AdjustVolume",
        "messageId": "{{STRING}}",
        "dialogRequestId": "{{STRING}}"
    },
    "payload": {
        "volume": {{LONG}}
    }
}

Payload参数说明

• volume
  • 音量调整相对值，[-100, 100]

VolumeChanged事件

音量发生变化时上报，包括SetVolume/AdjustVolume指令执行带来的变化，也包括其他方式的音量变化（如设备端上的音量控制按钮）。

消息样例

"event": {
    "header": {
        "namespace": "ai.dueros.device_interface.speaker_controller",
        "name": "VolumeChanged",
        "messageId": "{{STRING}}"
    },
    "payload": {
        "volume": {{LONG}},
        "muted": {{BOOLEAN}}
    }
}

Payload参数说明

• volume
  • 当前默认媒体音量值，[0, 100]
• muted
  • 是否静音状态：true为静音状态；false为非静音状态

SetMute指令

静音/取消静音。

消息样例

"directive": {
    "header": {
        "namespace": "ai.dueros.device_interface.speaker_controller",
        "name": "SetMute",
        "messageId": "{{STRING}}",
        "dialogRequestId": "{{STRING}}"
    },
    "payload": {
        "mute": {{BOOLEAN}}
    }
}

Payload参数说明

• mute
  • 静音设置：true为设置静音；false为取消静音

MuteChanged事件

静音/取消静音发生变化时上报。

消息样例

"event": {
    "header": {
        "namespace": "ai.dueros.device_interface.speaker_controller",
        "name": "MuteChanged",
        "messageId": "{{STRING}}"
    },
    "payload": {
        "volume": {{LONG}},
        "muted": {{BOOLEAN}}
    }
}

Payload参数说明

• volume
  • 当前音量值，[0, 100]
• muted
  • 是否静音状态：true为静音状态；false为非静音状态

状态上报

消息样例

"clientContext": [
    {
         "header": {
             "namespace": "ai.dueros.device_interface.speaker_controller",
             "name": "VolumeState"
         },
         "payload": {
             "volume": {{LONG}},
             "muted": {{BOOLEAN}}
         }
    }
]

Payload参数说明

• volume
  • 当前默认媒体音量值，[0, 100]
• muted
  • 是否静音状态：true为静音状态；false为非静音状态