StreamTransmit

The StreamTransmit object is used to get and set transmitted stream settings for the DM NVX device.

Syntax

  • HTTP Methods: GET, POST
  • Base URI: /Device/StreamTransmit/

Properties

Property Name Parent Path Version Description Type Methods Validation Rules
StreamTransmit /Device/ 2.0.0 The top‑level StreamTransmit object. Object N/A N/A
Streams /Device/StreamTransmit/ 2.0.0 A collection of all transmitted streams on the device. Object Collection GET, POST N/A
Uuid /Device/StreamTransmit/Streams/x/ 2.0.0 The unique ID for the stream. String GET N/A
MultiCastTtl /Device/StreamTransmit/Streams/x/ 2.0.0 The multicast TTL for the stream. Numeric (Unsigned 16-bit) GET, POST N/A
SnapshotUri /Device/StreamTransmit/Streams/x/ 2.0.0 The URI for the camera snapshot of the stream. String GET, POST N/A
SnapshotFileName /Device/StreamTransmit/Streams/x/ 2.0.0 The filename for the camera snapshot of the stream. String GET, POST N/A
RtspSessionName /Device/StreamTransmit/Streams/x/ 2.0.0 The RTSP session name. String GET, POST N/A
RtspStreamFileName /Device/StreamTransmit/Streams/x/ 2.0.0 The RTSP filename. String GET, POST N/A
Bitrate /Device/StreamTransmit/Streams/x/ 2.0.0 The bitrate of the stream, in Mbps. Numeric (Unsigned 16-bit) GET N/A
ActiveBitrate /Device/StreamTransmit/Streams/x/ 2.1.1 The bitrate of the active stream, in Mbps. Numeric (Unsigned 16-bit) GET N/A
CodecReady /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates whether the codec is ready to transmit the stream (true) or not (false). Boolean GET N/A
Status /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates the current stream state. String GET N/A
ElapsedSeconds /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates the time elapsed (in seconds) since streaming has started. Valid values range from 0d to 65535d.

When <ElapsedSeconds_F> exceeds 65535d, it resets to 0d.
Numeric (Unsigned 16-bit) GET N/A
FramesPerSecond /Device/StreamTransmit/Streams/x/ 2.0.0 The frame rate of the transmitted stream. Numeric (Unsigned 16-bit) GET N/A
MulticastAddress /Device/StreamTransmit/Streams/x/ 2.0.0 The multicast address of the transmitted stream. String GET, POST N/A
Password /Device/StreamTransmit/Streams/x/ 2.0.0 The password to be used to authenticate the stream. String POST N/A
IsPasswordProtectionEnabled /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates whether authentication is enabled on the stream (true) or not (false). Boolean GET, POST N/A
Pause /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates whether the stream is paused (true) or not (false). Boolean GET, POST N/A
Processing /Device/StreamTransmit/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/StreamTransmit/Streams/x/ 2.0.0 An enumeration to set or get the session initiation mode. String GET, POST N/A
Start /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates whether the stream is started (true) or not (false). Boolean GET, POST N/A
Stop /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates whether the stream is stopped (true) or not (false). Boolean GET, POST N/A
StreamLocation /Device/StreamTransmit/Streams/x/ 2.0.0 The full path of the server URL. String GET N/A
StreamProfile /Device/StreamTransmit/Streams/x/ 2.0.0 The H.264 profile of the stream. String GET, POST N/A
TransportMode /Device/StreamTransmit/Streams/x/ 2.0.0 The streaming transport mode. String GET, POST N/A
Username /Device/StreamTransmit/Streams/x/ 2.0.0 A username to authenticate the stream. String GET, POST N/A
RtspPort /Device/StreamTransmit/Streams/x/ 2.0.0 The TCP port number for the RTSP connection. Numeric (Unsigned 16-bit) GET, POST N/A
TsPort /Device/StreamTransmit/Streams/x/ 2.0.0 The TS port number for the stream. Numeric (Unsigned 16-bit) GET, POST N/A
RtpVideoPort /Device/StreamTransmit/Streams/x/ 2.0.0 The RTP video port number for the stream. Numeric (Unsigned 16-bit) GET, POST N/A
RtpAudioPort /Device/StreamTransmit/Streams/x/ 2.0.0 The RTP audio port number for the stream. Numeric (Unsigned 16-bit) GET, POST N/A
IsStatisticsEnabled /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates whether statistics are enabled for the stream (true) or not (false). Boolean GET, POST N/A
ResetStatistics /Device/StreamTransmit/Streams/x/ 2.0.0 Indicates whether the current stream statistics should be reset (true) or not (false). Boolean POST N/A
NumVideoPacketsTransmitted /Device/StreamTransmit/Streams/x/ 2.1.2 The number of video packets transmitted. Numeric (Unsigned 16-bit) GET N/A
NumAudioPacketsTransmitted /Device/StreamTransmit/Streams/x/ 2.1.2 The number of audio packets transmitted. Numeric (Unsigned 16-bit) GET N/A
HorizontalResolution /Device/StreamTransmit/Streams/x/ 2.0.0 The horizontal resolution of the stream. Numeric (Unsigned 16-bit) GET N/A
VerticalResolution /Device/StreamTransmit/Streams/x/ 2.0.0 The vertical resolution of the stream. Numeric (Unsigned 16-bit) GET N/A
IsAutomaticInitiationEnabled /Device/StreamTransmit/Streams/x/ 2.0.1 Indicates whether automatic initiation is enabled (true) or not (false). Boolean GET, POST N/A
AudioMode /Device/StreamTransmit/Streams/x/ 2.0.1 The audio mode of the stream. String GET N/A
IsAdaptiveBitrateMode /Device/StreamTransmit/Streams/x/ 2.1.0 Indicates whether adaptive bitrate mode is enabled (true) or not (false). Boolean GET, POST N/A
StreamEncodingType /Device/StreamTransmit/Streams/x/ 2.1.6 The type of encoding used for the stream. String GET, POST "Pixel Perfect Processing", "DM-NVX-D10/D20 Series"
BitrateMode /Device/StreamTransmit/Streams/x/ 2.1.5 The bitrate control mode. String GET, POST "Fixed", "Adaptive", "Variable"
NetworkAdapter /Device/StreamTransmit/Streams/x/ 2.1.7 The network adapter for the transmitted stream. String GET, POST N/A
StreamSource /Device/StreamTransmit/Streams/x/ 2.1.7 The source of the transmitted stream. String GET, POST N/A
Version /Device/StreamTransmit/ 2.1.7 "2.0.0": Initial public release,
"2.0.1": Added IsAutomaticInitiationEnabled, AudioMode,
"2.1.0": Added IsAdaptiveBitrateMode,
"2.1.1": Added ActiveBitrate, Changed Start/Stop/Pause to Read, Write,
"2.1.2": Property names changed,
"2.1.3": Added StreamType,
"2.1.4": Changed property name StreamType to StreamEncodingType as StreamType is already used in the StreamTransmit class,
"2.1.5": Added property BitrateMode,
"2.1.6": Updated admissible values for the StreamEncodingType property,
"2.1.7": Added NetworkAddress and StreamSource properties
String GET N/A

Example JSON

The following example JSON uses the current object version (2.1.7).

Copy
{
  "Device": {
    "StreamTransmit": {
      "Version": "2.1.7",
      "Streams": [
        {
          "UUID": "feba1d06-867b-42dd-b59c-7a80f92d1234",
          "MultiCastTtl": 0,
          "HdcpTransmitterMode": "FollowInput",
          "SnapshotUri": "",
          "SnapshotFileName": "",
          "RtspSessionName": "Crestron Streaming",
          "RtspStreamFileName": "",
          "Bitrate": 0,
          "ActiveBitrate": 0,
          "CodecReady": false,
          "Status": "Stream Stopped",
          "ElapsedSeconds": 0,
          "FramesPerSecond": 0,
          "EncodingResolution": "Auto",
          "MulticastAddress": "",
          "Password": "",
          "IsPasswordProtectionEnabled": true,
          "Pause": true,
          "Processing": false,
          "SessionInitiation": "ByReceiver",
          "Start": false,
          "Stop": false,
          "StreamLocation": "",
          "StreamProfile": "High",
          "TransportMode": "RTP",
          "Username": "",
          "RtspPort": 554,
          "TsPort": 4570,
          "RtpVideoPort": 40000,
          "RtpAudioPort": 40002,
          "IsStatisticsEnabled": true,
          "ResetStatistics": false,
          "NumVideoPacketsTransmitted": 0,
          "NumAudioPacketsTransmitted": 0,
          "AudioChannels": 2,
          "AudioFormat": "NoAudio|LPCM|LBR|HBR",
          "HorizontalResolution": 640,
          "VerticalResolution": 480,
          "IsAutomaticInitiationEnabled": true,
          "AudioMode": "Manual|Disabled",
          "IsAdaptiveBitrateMode": true,
          "StreamEncodingType": "Pixel Perfect Processing",
          "BitrateMode": "Adaptive",
          "NetworkAdapter": "Adapter0",
          "StreamSource": "Display0"
        }
      ]
    }
  }
}