bowen liu / Mbed OS mbed-os-example-blinky

ex

Fork of mbed-os-example-mbed5-blinky by mbed-os-examples

dumi_doc-master/doc/directives/Speaker.md@44:c1d8923072ba, 2017-07-18 (annotated)

Committer:
TMBOY
Date:
Tue Jul 18 16:27:22 2017 +0800
Revision:
44:c1d8923072ba
?

Who changed what in which revision?

UserRevisionLine numberNew contents of line
TMBOY 44:c1d8923072ba 1 # Speaker
TMBOY 44:c1d8923072ba 2
TMBOY 44:c1d8923072ba 3 ## Table of Contents
TMBOY 44:c1d8923072ba 4
TMBOY 44:c1d8923072ba 5
TMBOY 44:c1d8923072ba 6 * [Speaker](#speaker)
TMBOY 44:c1d8923072ba 7 * [Table of Contents](#table-of-contents)
TMBOY 44:c1d8923072ba 8 * [SetVolume指令](#setvolume指令)
TMBOY 44:c1d8923072ba 9 * [AdjustVolume指令](#adjustvolume指令)
TMBOY 44:c1d8923072ba 10 * [SetMute 指令](#setmute-指令)
TMBOY 44:c1d8923072ba 11 * [MuteChanged 事件](#mutechanged-事件)
TMBOY 44:c1d8923072ba 12 * [VolumeChanged事件](#volumechanged事件)
TMBOY 44:c1d8923072ba 13 * [Speaker状态上报](#speaker状态上报)
TMBOY 44:c1d8923072ba 14
TMBOY 44:c1d8923072ba 15
TMBOY 44:c1d8923072ba 16 ## SetVolume指令
TMBOY 44:c1d8923072ba 17 音量绝对控制指令, volumn取值为[0,100]
TMBOY 44:c1d8923072ba 18 ```json
TMBOY 44:c1d8923072ba 19 {
TMBOY 44:c1d8923072ba 20 "header": {
TMBOY 44:c1d8923072ba 21 "namespace": "Speaker",
TMBOY 44:c1d8923072ba 22 "name": "SetVolume",
TMBOY 44:c1d8923072ba 23 "message_id": "message_id-1344"
TMBOY 44:c1d8923072ba 24 },
TMBOY 44:c1d8923072ba 25 "payload": {
TMBOY 44:c1d8923072ba 26 "volume": 10
TMBOY 44:c1d8923072ba 27 }
TMBOY 44:c1d8923072ba 28 }
TMBOY 44:c1d8923072ba 29 ```
TMBOY 44:c1d8923072ba 30
TMBOY 44:c1d8923072ba 31 ## AdjustVolume指令
TMBOY 44:c1d8923072ba 32 音量相对控制指令，volume的取值范围为[-100,100]，正数表示增大音量，负数表示减小音量。
TMBOY 44:c1d8923072ba 33 ```json
TMBOY 44:c1d8923072ba 34 {
TMBOY 44:c1d8923072ba 35 "header": {
TMBOY 44:c1d8923072ba 36 "namespace": "Speaker",
TMBOY 44:c1d8923072ba 37 "name": "AdjustVolume",
TMBOY 44:c1d8923072ba 38 "message_id": "message_id-1344"
TMBOY 44:c1d8923072ba 39 },
TMBOY 44:c1d8923072ba 40 "payload": {
TMBOY 44:c1d8923072ba 41 "volume": -10
TMBOY 44:c1d8923072ba 42 }
TMBOY 44:c1d8923072ba 43 }
TMBOY 44:c1d8923072ba 44 ```
TMBOY 44:c1d8923072ba 45
TMBOY 44:c1d8923072ba 46 ## SetMute 指令
TMBOY 44:c1d8923072ba 47 设置静音状态打开／关闭。mute取值：true静音；false取消静音。
TMBOY 44:c1d8923072ba 48 ```json
TMBOY 44:c1d8923072ba 49 {
TMBOY 44:c1d8923072ba 50 "header": {
TMBOY 44:c1d8923072ba 51 "namespace": "Speaker",
TMBOY 44:c1d8923072ba 52 "name": "SetMute",
TMBOY 44:c1d8923072ba 53 "message_id": "message_id-1344"
TMBOY 44:c1d8923072ba 54 },
TMBOY 44:c1d8923072ba 55 "payload": {
TMBOY 44:c1d8923072ba 56 "mute": true
TMBOY 44:c1d8923072ba 57 }
TMBOY 44:c1d8923072ba 58 }
TMBOY 44:c1d8923072ba 59 ```
TMBOY 44:c1d8923072ba 60
TMBOY 44:c1d8923072ba 61
TMBOY 44:c1d8923072ba 62 ## MuteChanged 事件
TMBOY 44:c1d8923072ba 63 静音状态改变的事件上报
TMBOY 44:c1d8923072ba 64 ```json
TMBOY 44:c1d8923072ba 65 "device_event": {
TMBOY 44:c1d8923072ba 66 "header": {
TMBOY 44:c1d8923072ba 67 "namespace": "Speaker",
TMBOY 44:c1d8923072ba 68 "name": "MuteChanged",
TMBOY 44:c1d8923072ba 69 "message_id": "message_id-1344"
TMBOY 44:c1d8923072ba 70 },
TMBOY 44:c1d8923072ba 71 "payload": {
TMBOY 44:c1d8923072ba 72 "muted": true,
TMBOY 44:c1d8923072ba 73 "volume": 10
TMBOY 44:c1d8923072ba 74 }
TMBOY 44:c1d8923072ba 75 }
TMBOY 44:c1d8923072ba 76 ```
TMBOY 44:c1d8923072ba 77
TMBOY 44:c1d8923072ba 78
TMBOY 44:c1d8923072ba 79 ## VolumeChanged事件
TMBOY 44:c1d8923072ba 80 ```json
TMBOY 44:c1d8923072ba 81 "device_event": {
TMBOY 44:c1d8923072ba 82 "header": {
TMBOY 44:c1d8923072ba 83 "namespace": "Speaker",
TMBOY 44:c1d8923072ba 84 "name": "VolumeChanged",
TMBOY 44:c1d8923072ba 85 "message_id": "message_id-1344"
TMBOY 44:c1d8923072ba 86 },
TMBOY 44:c1d8923072ba 87 "payload": {
TMBOY 44:c1d8923072ba 88 "volume": 10
TMBOY 44:c1d8923072ba 89 }
TMBOY 44:c1d8923072ba 90 }
TMBOY 44:c1d8923072ba 91 ```
TMBOY 44:c1d8923072ba 92
TMBOY 44:c1d8923072ba 93
TMBOY 44:c1d8923072ba 94 ## Speaker状态上报
TMBOY 44:c1d8923072ba 95 正常请求中也需要上报Speaker当前的状态
TMBOY 44:c1d8923072ba 96 ```json
TMBOY 44:c1d8923072ba 97 "device_status":{
TMBOY 44:c1d8923072ba 98 "Speaker":{
TMBOY 44:c1d8923072ba 99 "volume": 50,
TMBOY 44:c1d8923072ba 100 "muted": false
TMBOY 44:c1d8923072ba 101 }
TMBOY 44:c1d8923072ba 102 }
TMBOY 44:c1d8923072ba 103 ```
TMBOY 44:c1d8923072ba 104
TMBOY 44:c1d8923072ba 105