StreamReceive
The StreamReceive object is used to get and set received stream settings for the DM NVX device.
Syntax
- HTTP Methods: GET, POST
- Base URI: /Device/StreamReceive/
Properties
| Property Name | Parent Path | Version | Description | Type | Methods | Validation Rules |
|---|---|---|---|---|---|---|
| StreamReceive | /Device/ | 2.0.0 | The top‑level StreamReceive object. | Object | GET, POST | N/A |
| Streams | /Device/StreamReceive/ | 2.0.0 | A collection of streams on the device. | Object Collection | GET, POST | N/A |
| Bitrate | /Device/StreamReceive/Streams/x/ | 2.0.0 | The bitrate of the stream in Mbps. | Numeric (Unsigned 16-bit) | GET | N/A |
| CodecReady | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates whether the codec is ready to receive the stream (true) or not (false). | Boolean | GET | N/A |
| Status | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates the current stream state. | String | GET | N/A |
| ElapsedSeconds | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates the time that has elapsed since the stream started. When <ElapsedSeconds_F> exceeds 65535d, it resets to 0d. |
Numeric (Unsigned 16-bit) | GET | N/A |
| InitiatorAddress | /Device/StreamReceive/Streams/x/ | 2.0.0 | The address of the device connected to the receiver. | String | GET, POST | N/A |
| MulticastAddress | /Device/StreamReceive/Streams/x/ | 2.0.0 | The multicast address of the device connected to the receiving device. | String | GET, POST | N/A |
| Password | /Device/StreamReceive/Streams/x/ | 2.0.0 | The password required to connect to the stream transmitter. | String | GET, POST | N/A |
| IsPasswordProtectionEnabled | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates whether authentication should be used when connecting to the stream transmitter (true) or not (false). | Boolean | GET, POST | N/A |
| Pause | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates whether the stream is paused (true) or not (false). | Boolean | GET, POST | N/A |
| Processing | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates that the device is changing state (starting the stream, stopping the stream, etc.) and is busy. Wait until the state is false before sending commands to the device. |
Boolean | GET | N/A |
| SessionInitiation | /Device/StreamReceive/Streams/x/ | 2.0.0 | An enumeration to set or get the session initiation mode. | String | GET, POST | N/A |
| Start | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates whether the stream is started (true) or not (false). | Boolean | GET, POST | N/A |
| Stop | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates whether the stream is stopped (true) or not (false). | Boolean | GET, POST | N/A |
| StreamLocation | /Device/StreamReceive/Streams/x/ | 2.0.0 | The full path of the server URL. | String | GET, POST | N/A |
| StreamProfile | /Device/StreamReceive/Streams/x/ | 2.0.0 | the H.264 profile of the stream. | String | GET | N/A |
| Buffer | /Device/StreamReceive/Streams/x/ | 2.0.0 | Specifies the length of video that will be cached, in milliseconds. | Numeric (Unsigned 16-bit) | GET, POST | N/A |
| TransportMode | /Device/StreamReceive/Streams/x/ | 2.0.0 | Reports the streaming transport mode. | String | GET | N/A |
| Username | /Device/StreamReceive/Streams/x/ | 2.0.0 | The username used to connect to the stream transmitter. | String | GET, POST | N/A |
| RtspPort | /Device/StreamReceive/Streams/x/ | 2.0.0 | The TCP port number for the RTSP connection. | Numeric (Unsigned 16-bit) | GET, POST | N/A |
| TsPort | /Device/StreamReceive/Streams/x/ | 2.0.0 | The TS port number for the stream. | Numeric (Unsigned 16-bit) | GET, POST | N/A |
| RtpVideoPort | /Device/StreamReceive/Streams/x/ | 2.0.0 | The RTP video port number for the stream. | Numeric (Unsigned 16-bit) | GET, POST | N/A |
| RtpAudioPort | /Device/StreamReceive/Streams/x/ | 2.0.0 | The RTP audio port number for the stream. | Numeric (Unsigned 16-bit) | GET, POST | N/A |
| IsStatisticsEnabled | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates whether statistics are enabled (true) or not (false) for the stream. | Boolean | GET, POST | N/A |
| ResetStatistics | /Device/StreamReceive/Streams/x/ | 2.0.0 | Indicates whether current stream statistics should be reset (true) or not (false). | Boolean | POST | N/A |
| NumVideoPacketsRcvd | /Device/StreamReceive/Streams/x/ | 2.0.0 | The number of received video packets. | Numeric (Unsigned 16-bit) | GET | N/A |
| NumVideoPacketsDropped | /Device/StreamReceive/Streams/x/ | 2.0.0 | The number of dropped video packets. | Numeric (Unsigned 16-bit) | GET | N/A |
| NumAudioPacketsRcvd | /Device/StreamReceive/Streams/x/ | 2.0.0 | The number of received audio packets. | Numeric (Unsigned 16-bit) | GET | N/A |
| NumAudioPacketsDropped | /Device/StreamReceive/Streams/x/ | 2.0.0 | The number of dropped audio packets. | Numeric (Unsigned 16-bit) | GET | N/A |
| HorizontalResolution | /Device/StreamReceive/Streams/x/ | 2.0.0 | The horizontal resolution of the received stream. | Numeric (Unsigned 16-bit) | GET | N/A |
| VerticalResolution | /Device/StreamReceive/Streams/x/ | 2.0.0 | The vertical resolution of the received stream. | Numeric (Unsigned 16-bit) | GET | N/A |
| FramesPerSecond | /Device/StreamReceive/Streams/x/ | 2.0.0 | The framerate of the received stream. | Numeric (Unsigned 16-bit) | GET | N/A |
| AspectRatio | /Device/StreamReceive/Streams/x/ | 2.0.0 | The aspect ratio of the received stream. | String | GET | N/A |
| AudioChannels | /Device/StreamReceive/Streams/x/ | 2.0.0 | The number of audio channels received in the stream. | Numeric (Unsigned 16-bit) | GET | N/A |
| AudioFormat | /Device/StreamReceive/Streams/x/ | 2.0.0 | The audio format of the received stream. | String | GET | N/A |
| IsAutomaticInitiationEnabled | /Device/StreamReceive/Streams/x/ | 2.0.1 | Indicates whether automatic initiation is enabled (true) or not (false). | Boolean | GET, POST | N/A |
| AudioMode | /Device/StreamReceive/Streams/x/ | 2.0.1 | The audio mode for the stream. | String | GET | N/A |
| Version | /Device/StreamReceive/ | 2.0.1 | "2.0.0": Initial public release, "2.0.1": Added IsAutomaticInitiationEnabled, AudioMode, Changed Start/Stop/Pause to Read, Write |
String | GET | N/A |
Example JSON
The following example JSON uses the current object version (2.0.1).
Copy
{
"Device":{
"StreamReceive":{
"Version":"2.0.1",
"Streams":[
{
"Bitrate":0,
"CodecReady":false,
"Status":"Stream Stopped",
"ElapsedSeconds":0,
"InitiatorAddress":"",
"MulticastAddress":"",
"Password":"",
"IsPasswordProtectionEnabled":true,
"Pause":true,
"Processing":false,
"SessionInitiation":"ByReceiver",
"Start":false,
"Stop":false,
"StreamLocation":"",
"StreamProfile":"High",
"Buffer":0,
"TransportMode":"RTP",
"Username":"",
"RtspPort":554,
"TsPort":4570,
"RtpVideoPort":40000,
"RtpAudioPort":40002,
"IsStatisticsEnabled":true,
"ResetStatistics":false,
"NumVideoPacketsRcvd":0,
"NumVideoPacketsDropped":0,
"NumAudioPacketsRcvd":0,
"NumAudioPacketsDropped":0,
"HorizontalResolution":640,
"VerticalResolution":480,
"FramesPerSecond":60,
"AspectRatio":"16:10",
"AudioChannels":2,
"AudioFormat":"Lpcm",
"IsAutomaticInitiationEnabled":true,
"AudioMode": "Manual|Disabled",
}
}
]
}
}
}