Skip to main content

GetAudioStreamConfig

Retrieves audio stream configuration including encoding, input source, and volume levels.

Endpoint

FieldValue
MethodPOST or GET
URLhttp://<host>[:port]/GetAudioStreamConfig[/channelId]
ProductsIPC, NVR
Channel IDOptional (default 1)
v2.0 Only

This command does not exist on v1.9 firmware.

Response Fields

FieldTypeDescription
audioInSwitchbooleanAudio input enabled/disabled
audioEncodeaudioEncodeEAudio encoding format
audioInputaudioInputEAudio input source type
linInVolumeuint32Line-in volume (0--100)
micInVolumeuint32Microphone volume (0--100)
audioOutVolumeuint32Audio output volume (0--100)
audioOutputaudioOutputEAudio output mode

Audio Encode Types

TypeDescription
G711AG.711 A-law (8kHz, 64kbps)
G711UG.711 mu-law (8kHz, 64kbps)

Audio Input Types

TypeDescription
MICMicrophone input
LINLine-in input

Audio Output Types

TypeDescription
TALKBACKTwo-way audio talkback
ALARM_AUDIOAlarm audio output
AUTOAutomatic selection

Response

<?xml version="1.0" encoding="UTF-8"?>
<config version="2.0.0" xmlns="http://www.ipc.com/ver10">
<types>
<audioEncodeE>
<enum>G711A</enum>
<enum>G711U</enum>
</audioEncodeE>
<audioInputE>
<enum>MIC</enum>
<enum>LIN</enum>
</audioInputE>
<audioOutputE>
<enum>TALKBACK</enum>
<enum>ALARM_AUDIO</enum>
<enum>AUTO</enum>
</audioOutputE>
</types>
<audioInSwitch type="boolean">true</audioInSwitch>
<audioEncode type="audioEncodeE">G711U</audioEncode>
<audioInput type="audioInputE">MIC</audioInput>
<volume>
<linInVolume type="uint32" min="0" max="100">75</linInVolume>
<micInVolume type="uint32" min="0" max="100">75</micInVolume>
<audioOutVolume type="uint32" min="0" max="100">75</audioOutVolume>
</volume>
<audioOutput type="audioOutputE">ALARM_AUDIO</audioOutput>
</config>

Notes

  • Check audioInCount and audioOutCount from GetDeviceInfo to confirm audio hardware availability before using this endpoint.
  • Volume levels for all three channels (line-in, microphone, output) are independently configurable from 0 to 100.