#xiaomi.btspker.oh3s

Xiaomi 随身蓝牙音箱

urn:miot-spec-v2:device:ble-speaker:0000A0E4:xiaomi-oh3s:1

版本 v2 v1

← 返回产品详情下载米家插件

语言

Service tree

扬声器

#2 · speaker

属性 1

Properties

标签	格式	读写	值
音量 #1 · volume	uint8		0 ~ 100，步长 1

音量

#1 · volume

格式: uint8
读写
值: 0 ~ 100，步长 1

电池状态

#3 · battery

属性 2

Properties

标签	格式	读写	值
电池电量 #1 · battery-level	uint8		0 ~ 100，步长 1
充电状态 #2 · charging-state	bool		—

电池电量

#1 · battery-level

格式: uint8
读写
值: 0 ~ 100，步长 1

充电状态

#2 · charging-state

格式: bool
读写
值: —

播放控制

#4 · play-control

属性 6动作 4

Properties

标签	格式	值
播放状态 #1 · playing-state	uint8	1Playing 2Pause
播放模式 #2 · playing-mode	uint8	1BT-mode 2LOCAL-mode 3USB-mode
循环模式 #3 · cycle-mode	uint8	1List-cycle 2Random-cycle 3One-cycle
音乐总播放时长 #4 · music-total-time	string	—
音乐当前播放时间 #5 · music-cur-time	string	—
本地模式已禁用 #6 · local-mode-disabled	bool	—

播放状态

#1 · playing-state

格式: uint8
读写
值: 1Playing
2Pause

播放模式

#2 · playing-mode

格式: uint8
读写
值: 1BT-mode
2LOCAL-mode
3USB-mode

循环模式

#3 · cycle-mode

格式: uint8
读写
值: 1List-cycle
2Random-cycle
3One-cycle

音乐总播放时长

#4 · music-total-time

格式: string
读写
值: —

音乐当前播放时间

#5 · music-cur-time

格式: string
读写
值: —

本地模式已禁用

#6 · local-mode-disabled

格式: bool
读写
值: —

Actions

播放

#1 · play

暂停

#2 · pause

上一首

#3 · previous

下一首

#4 · next

灯光

#5 · light

属性 3

Properties

标签	格式	值
灯光开关 #1 · on	bool	—
氛围灯的颜色 #2 · color	uint32	0 ~ 16777215，步长 1
氛围灯的模式 #3 · mode	uint8	21Flow 22Flare 1Color 23Breath

灯光开关

#1 · on

格式: bool
读写
值: —

氛围灯的颜色

#2 · color

格式: uint32
读写
值: 0 ~ 16777215，步长 1

氛围灯的模式

#3 · mode

格式: uint8
读写
值: 21Flow
22Flare
1Color
23Breath

音箱设置项

#6 · setting

属性 5

Properties

标签	格式	值
自动关机 #1 · auto-shutdown	bool	—
自动关机时长 #2 · auto-shutdown-time	uint16	1 ~ 300，步长 1
提示音播报 #4 · prompt-broadcast	bool	—
指示灯 #5 · indicator-light	bool	—
开机电量广播开关 #6 · power-broadcast	bool	—

自动关机

#1 · auto-shutdown

格式: bool
读写
值: —

自动关机时长

#2 · auto-shutdown-time

格式: uint16
读写
值: 1 ~ 300，步长 1

提示音播报

#4 · prompt-broadcast

格式: bool
读写
值: —

指示灯

#5 · indicator-light

格式: bool
读写
值: —

开机电量广播开关

#6 · power-broadcast

格式: bool
读写
值: —

音效

#7 · sound-effect

属性 11动作 5

Properties

标签	格式	值
音效模式 #1 · mode	uint8	1Balance 2Indoor 3Outdoor 4Custom 0Null
高音 #2 · treble	int8	-6 ~ 6，步长 1
低音 #3 · bass	int8	-6 ~ 6，步长 1
听感测试的步数 #4 · st-step	uint8	1 ~ 255，步长 1
播放选项 #5 · st-play-option	uint8	1A Sound Effect 2B Sound Effect
用户选择的选项 #6 · st-user-option	uint8	1A Better 2B Better 3Both Well 4None Well
个性化听感模式id #7 · st-custom-mode-id	uint8	1 ~ 255，步长 1
听感测试中增益数组字符串 #8 · st-gain	string	—
个性化听感模式绘图系数 #9 · st-ratio	string	—
中音 #10 · mid	int8	-6 ~ 6，步长 1
设备主动请求停止听感测试 #11 · st-device-cancel	uint8	0NotCancel 1StateChanged 2Timeout

音效模式

#1 · mode

格式: uint8
读写
值: 1Balance
2Indoor
3Outdoor
4Custom
0Null

高音

#2 · treble

格式: int8
读写
值: -6 ~ 6，步长 1

低音

#3 · bass

格式: int8
读写
值: -6 ~ 6，步长 1

听感测试的步数

#4 · st-step

格式: uint8
读写
值: 1 ~ 255，步长 1

播放选项

#5 · st-play-option

格式: uint8
读写
值: 1A Sound Effect
2B Sound Effect

用户选择的选项

#6 · st-user-option

格式: uint8
读写
值: 1A Better
2B Better
3Both Well
4None Well

个性化听感模式id

#7 · st-custom-mode-id

格式: uint8
读写
值: 1 ~ 255，步长 1

听感测试中增益数组字符串

#8 · st-gain

格式: string
读写
值: —

个性化听感模式绘图系数

#9 · st-ratio

格式: string
读写
值: —

中音

#10 · mid

格式: int8
读写
值: -6 ~ 6，步长 1

设备主动请求停止听感测试

#11 · st-device-cancel

格式: uint8
读写
值: 0NotCancel
1StateChanged
2Timeout

Actions

听感测试-调整音效/开始/取消/完成

#1 · st-adjust-effect

入参

#4听感测试的步数uint8#5播放选项uint8

出参

#7个性化听感模式iduint8#8听感测试中增益数组字符串string#9个性化听感模式绘图系数string

听感测试-用户选中选项进入下一步的动作

#2 · st-select-effect

入参

#4听感测试的步数uint8#6用户选择的选项uint8

设置个性化听感模式

#3 · st-set-custom-mode

入参

#7个性化听感模式iduint8#8听感测试中增益数组字符串string

听感测试-试听功能

#4 · st-audition

入参

#8听感测试中增益数组字符串string

删除个性化听感模式

#5 · st-del-custom-mode

入参

#7个性化听感模式iduint8#8听感测试中增益数组字符串string

组合播放

#8 · combine-playback

属性 4动作 1

Properties

标签	格式	值
组合播放开关 #1 · on	bool	—
组合播放模式 #2 · mode	uint8	1Stereo 2Part
组合设备 #3 · combine-equip	string	—
音箱状态 #4 · combine-state	uint8	0None 1TWSMaster 2TWSSlave 3BISMaster 4BISSlave

组合播放开关

#1 · on

格式: bool
读写
值: —

组合播放模式

#2 · mode

格式: uint8
读写
值: 1Stereo
2Part

组合设备

#3 · combine-equip

格式: string
读写
值: —

音箱状态

#4 · combine-state

格式: uint8
读写
值: 0None
1TWSMaster
2TWSSlave
3BISMaster
4BISSlave

Actions

组合设备

#1 · combine-equip

入参

#3组合设备string

其它自定义功能

#9 · custom

属性 1动作 1

Properties

标签	格式	读写	值
Xiaomi 蓝牙音箱 #1 · default-device-name	string		—

Xiaomi 蓝牙音箱

#1 · default-device-name

格式: string
读写
值: —

Actions

退出固件升级页面

#1 · exit-fw-upgrade-page

蓝牙音箱本体

#10 · bluetooth-speaker

属性 1

Properties

标签	格式	读写	值
连接状态 #1 · connect-state	uint8		1NotConnected 2Connected

连接状态

#1 · connect-state

格式: uint8
读写
值: 1NotConnected
2Connected

WiFi

#11 · wifi

属性 7动作 6

Properties

标签	格式	值
wifi状态 #1 · wifi-state	uint8	1NotConnected 2Connecting 3Connected
WiFi SSID #2 · wifi-ssid	string	—
WiFi 密码 #3 · wifi-password	string	—
连接异常错误码 #4 · error-code	uint8	0Success 1Failed-Password 2Failed-No-Wifi 3Failed-Timeout 4Failed-IP 5Failed-Protocol
WiFi列表成员（二维数组形式） #5 · scan-wifi-member	string	—
心跳间隔 #6 · keep-alive-interval	uint8	0 ~ 100，步长 1
最大丢失的心跳次数 #7 · keep-alive-max-miss	uint8	0 ~ 100，步长 1

wifi状态

#1 · wifi-state

格式: uint8
读写
值: 1NotConnected
2Connecting
3Connected

WiFi SSID

#2 · wifi-ssid

格式: string
读写
值: —

WiFi 密码

#3 · wifi-password

格式: string
读写
值: —

连接异常错误码

#4 · error-code

格式: uint8
读写
值: 0Success
1Failed-Password
2Failed-No-Wifi
3Failed-Timeout
4Failed-IP
5Failed-Protocol

WiFi列表成员（二维数组形式）

#5 · scan-wifi-member

格式: string
读写
值: —

心跳间隔

#6 · keep-alive-interval

格式: uint8
读写
值: 0 ~ 100，步长 1

最大丢失的心跳次数

#7 · keep-alive-max-miss

格式: uint8
读写
值: 0 ~ 100，步长 1

Actions

连接Wifi

#1 · connect

入参

#2WiFi SSIDstring#3WiFi 密码string

连接无密码的Wifi

#2 · connect-only-ssid

入参

#2WiFi SSIDstring

启动WiFi扫描

#3 · wifi-scan-open

入参

#6心跳间隔uint8#7最大丢失的心跳次数uint8

关闭WiFi扫描

#4 · wifi-scan-close

wifi-keep-alive

#5 · wifi-keep-alive

keep-alive-close

#6 · keep-alive-close

SD卡

#12 · sd

属性 4动作 1

Properties

标签	格式	值
SD卡状态 #1 · sd-state	uint8	1Normal 2Abnormal
存储总量 #2 · sd-storage-total	string	—
已使用存储空间 #3 · sd-storage-used	string	—
存储空间不足 #4 · sd-storage-full	bool	—

SD卡状态

#1 · sd-state

格式: uint8
读写
值: 1Normal
2Abnormal

存储总量

#2 · sd-storage-total

格式: string
读写
值: —

已使用存储空间

#3 · sd-storage-used

格式: string
读写
值: —

存储空间不足

#4 · sd-storage-full

格式: bool
读写
值: —

Actions

格式化

#1 · sd-format

播放列表

#13 · playing-list

属性 17动作 10

Properties

标签	格式	值
歌曲ID #1 · music-id	string	—
歌曲ID列表 #2 · music-ids	string	—
读取ids分区的起始值 #3 · music-ids-offset	uint16	0 ~ 65535，步长 1
读取ids的数量 #4 · music-ids-count	uint8	0 ~ 100，步长 1
歌曲信息 #5 · music-info	string	—
refresh-token #6 · refresh-token	string	—
用户ID #7 · user-id	string	—
CP方音乐源 #8 · cp-name	uint8	1QQ 2WY
同步状态 #9 · sync-state	uint8	1Synchronizing 2Idle 3Finish 4Error
同步收藏开关 #10 · sync-favorite-switch	bool	—
网易云音乐已下载歌曲数 #11 · music-downloaded-wy	uint16	0 ~ 65535，步长 1
Q音已下载歌曲数 #12 · music-downloaded-qq	uint16	0 ~ 65535，步长 1
同步中的总数 #13 · sync-total	uint16	0 ~ 65535，步长 1
已完成同步的数量 #14 · sync-completed	uint16	0 ~ 65535，步长 1
同步异常的歌曲数量 #15 · sync-error	uint16	0 ~ 65535，步长 1
同步错误代码 #16 · error-code	uint8	0Not-error 1Network-error 2Insufficient-storage 3Download-prohibited 4Download-limit-exceeded
本地歌曲信息同步key #17 · music-data-key	int64	0 ~ 999999999999999，步长 1

歌曲ID

#1 · music-id

格式: string
读写
值: —

歌曲ID列表

#2 · music-ids

格式: string
读写
值: —

读取ids分区的起始值

#3 · music-ids-offset

格式: uint16
读写
值: 0 ~ 65535，步长 1

读取ids的数量

#4 · music-ids-count

格式: uint8
读写
值: 0 ~ 100，步长 1

歌曲信息

#5 · music-info

格式: string
读写
值: —

refresh-token

#6 · refresh-token

格式: string
读写
值: —

用户ID

#7 · user-id

格式: string
读写
值: —

CP方音乐源

#8 · cp-name

格式: uint8
读写
值: 1QQ
2WY

同步状态

#9 · sync-state

格式: uint8
读写
值: 1Synchronizing
2Idle
3Finish
4Error

同步收藏开关

#10 · sync-favorite-switch

格式: bool
读写
值: —

网易云音乐已下载歌曲数

#11 · music-downloaded-wy

格式: uint16
读写
值: 0 ~ 65535，步长 1

Q音已下载歌曲数

#12 · music-downloaded-qq

格式: uint16
读写
值: 0 ~ 65535，步长 1

同步中的总数

#13 · sync-total

格式: uint16
读写
值: 0 ~ 65535，步长 1

已完成同步的数量

#14 · sync-completed

格式: uint16
读写
值: 0 ~ 65535，步长 1

同步异常的歌曲数量

#15 · sync-error

格式: uint16
读写
值: 0 ~ 65535，步长 1

同步错误代码

#16 · error-code

格式: uint8
读写
值: 0Not-error
1Network-error
2Insufficient-storage
3Download-prohibited
4Download-limit-exceeded

本地歌曲信息同步key

#17 · music-data-key

格式: int64
读写
值: 0 ~ 999999999999999，步长 1

Actions

删除本地音乐

#1 · delete-music-by-ids

入参

#2歌曲ID列表string#8CP方音乐源uint8

设置同步信息

#2 · set-sync-info

入参

#6refresh-tokenstring#7用户IDstring

同步音乐

#3 · sync-music

入参

#2歌曲ID列表string#8CP方音乐源uint8

获取歌曲id列表

#4 · get-music-ids

入参

#3读取ids分区的起始值uint16#4读取ids的数量uint8#8CP方音乐源uint8

出参

#2歌曲ID列表string

根据歌曲ID获取歌曲信息

#5 · get-music-info

入参

#1歌曲IDstring#8CP方音乐源uint8

出参

#5歌曲信息string

根据歌曲ID播放歌曲

#6 · play-music-id

入参

#1歌曲IDstring#8CP方音乐源uint8

重置歌曲同步状态(用于取消已完成和异常)

#7 · reset-sync-state

根据分区获取歌曲异常列表信息

#8 · get-sync-error-info

入参

#3读取ids分区的起始值uint16#4读取ids的数量uint8

出参

#2歌曲ID列表string

强制中止下载

#9 · sync-forced-end

分页获取歌曲ids

#10 · get-music-ids-nocp

入参

#3读取ids分区的起始值uint16#4读取ids的数量uint8

出参

#2歌曲ID列表string

CP方账号状态

#14 · cp-account-status

属性 4动作 1

Properties

标签	格式	值
QQ音乐账号绑定状态 #1 · qq-account-binding	uint8	0Not-binding 1Not-VIP 2VIP
网易账号绑定状态 #2 · wy-account-binding	uint8	0Not-binding 1Not-VIP 2VIP
QQ音乐vip过期时间 #3 · qq-vip-expired-time	uint32	0 ~ 4294967295，步长 1
网易云音乐vip过期时间戳 #4 · wy-vip-expired-time	uint32	0 ~ 4294967295，步长 1

QQ音乐账号绑定状态

#1 · qq-account-binding

格式: uint8
读写
值: 0Not-binding
1Not-VIP
2VIP

网易账号绑定状态

#2 · wy-account-binding

格式: uint8
读写
值: 0Not-binding
1Not-VIP
2VIP

QQ音乐vip过期时间

#3 · qq-vip-expired-time

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

网易云音乐vip过期时间戳

#4 · wy-vip-expired-time

格式: uint32
读写
值: 0 ~ 4294967295，步长 1

Actions

cp方账户状态

#1 · cp-account-status

入参

#1QQ音乐账号绑定状态uint8#2网易账号绑定状态uint8#3QQ音乐vip过期时间uint32#4网易云音乐vip过期时间戳uint32

鉴权快速测试

#15 · demo-test

属性 2

Properties

标签	格式	读写	值
绑定周期鉴权控制开关 #1 · binding-life-ctrl	bool		—
vip鉴权控制开关 #2 · vip-life-ctrl	bool		—

绑定周期鉴权控制开关

#1 · binding-life-ctrl

格式: bool
读写
值: —

vip鉴权控制开关

#2 · vip-life-ctrl

格式: bool
读写
值: —