audio.speech.level: Read alarm speech volume (dB)

audio.speech.level · Device scope · Permission Config

Feature details

Some models use string enum "1"–"5"; others use JSON number 1–5—follow read-back. Read device alarm voice dB. 50/60/70/80/90 dB. The standard path is the device property audio.speech.level; some models parallel AbAlarmSound or legacy OpenAPI volume interfaces (such asgetSoundVolumeSize) in the registry, and the ability leaf and this property still prevail. See the alarm voice directory.

Request address

POST https://openapi-[DataCenter].easy4ip.com/openapi/v2/device.property.get

Minimum permission

Administrators do not need permission to operate self-bound devices. Basic configuration permission is required to operate the shared device. Child user binding is not required. Sub-account requires Config.

Request parameters

Common request fields and the signature are in Development specification.

Request example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system": {
 "ver": "1.0",
 "appId": "lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time": 1706511734,
 "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
 },
 "params": {
 "token": "<yourAccessToken>",
 "deviceId": "TESTIPC000012345",
 "properties": [
 "audio.speech.level"
 ]
 }
}

# # # Returns a description of the data field

The value is in result.data.properties["audio.speech.level"].

Response example

{
 "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "result": {
 "code": "0",
 "msg": "Operation is successful",
 "data": {
 "properties": {
 "audio.speech.level": "50"
 }
 }
 }
}

Error Code

Gateway and device error codes are in Global return codes.

Set sound decibel setting properties · Alarm voice