The entire configuration of the Audio Monitoring App can be done in two ways:
-
Stand-alone application Riedel AMA Config Tool (->AMA Config Tool)
-
API interface (via a broadcast controller)
The following properties can be configured:
The audio monitoring sources (AMS) ...
-
can be defined as IP/SDP or NMOS
-
can be in synchronous as well as in synton mode
-
can be mono or stereo sources
-
can be connected to audio channels of one or more streams
-
can be provided with titles/subtitles and grouped by color
Each channel of an audio monitoring source can have individual stream settings:
-
mono signal from a single stream
-
Stereo signal from a single stream
-
Stereo signal from multiple streams
The number of channels in the stream itself is not limited. However, one Audio Monitoring Source (AMS) can only consist of a maximum of 2 channels.
The following functions are supported by the API:
(Default values are shown in italics and underlined.)
|
|
GET |
PUT |
POST |
DELETE |
|
/global-settings
|
|
|
|
|
|
/media-state
|
|
|
|
|
|
/device-information
|
|
|
|
|
|
/settings/ama
|
|
|
|
|
|
/settings/nmos
|
|
|
|
|
|
/audio-monitoring-sources
|
|
|
|
|
|
/audio-monitoring-sources/{id}
|
|
|
|
|
|
/key-mapping
|
|
|
|
|
/global-settings
|
amaMode |
Setting whether the application is active or inactive. (Active, Inactive) |
/media-state
|
amsID |
Unique ID of the audio source to be monitored. (String: $uuid) |
||
|
streamStates |
leftLeg rightLeg |
media1State media2State |
Stream status information per route and AMS ID. (Active, Inactive) |
/device-information
|
deviceType |
Information of SmartPanel types. (RSP1232HL, RSP1216HL) |
/settings/ama
|
loacalPersistence |
Restore configured audio sources after reboot. (Disabled, Enabled) |
|
|
audio |
trimLevelInDb |
Level of all monitored audio sources. (-72.3 ... 0 ... +18 dB) |
|
legRoleOrder |
NMOS IS-08 Channel Order. (Left, Right / Right, Left) |
|
|
display |
groupColorDisplay
|
Position of the group color. (None, OnDisplay, OnKeyRing) |
|
peakMeterClipping |
Enables the clipping warning. (Disabled, Enabled) |
|
|
clipIndication
|
Time how long a clipping is signaled. (1000 ... 3000 ... 10000 ms) |
|
|
input |
secondaryFunction
|
Enables the Key Display Functions. (Disabled, Enabled) |
|
interApp
|
amaDucking |
Configures the AMA ducking behavior. (Disabled, DB_Minus_3, DB_Minus_6, DB_Minus_9, DB_Minus_12, DB_Minus_18, DB_Minus_24, Mute) |
|
intercomHeadset
|
Configures the intercom headset behavior. (Disabled, DB_Minus_3, DB_Minus_6, DB_Minus_9, DB_Minus_12, DB_Minus_18, DB_Minus_24, Mute) |
|
|
intercomSpeaker
|
Configures the intercom speaker behavior. (Disabled, DB_Minus_3, DB_Minus_6, DB_Minus_9, DB_Minus_12, DB_Minus_18, DB_Minus_24, Mute) |
|
|
keybank |
color |
Color of the key bank. (SandyBrown, UnmellowYellow, MediumSpringBud, Inchworm, ScreaminGreen, MintGreen, Aquamarine, ElectricBlue, MayaBlue, MediumSlateBlue, BrightLavender, Heliotrope, PaleMagenta, HotPink, Timberwolf) |
|
name |
Name of the key bank. (String: Monitoring) |
|
/settings/nmos
|
nodePort |
(1024 ... 8080 ... 65535) |
|
|
nodeVersions |
(Unknown, v1_1, v1_2, v1_3) |
|
|
registrationMode |
(Static, Auto, P2P) |
|
|
Registry |
ip |
($ipv4) |
|
port |
(1 ... 9696 ... 65535) |
|
|
version |
(Unknown, v1_1, v1_2, v1_3) |
|
|
searchDomain |
(String) |
|
/audio-monitoring-sources
|
id |
Unique ID of the AMS to be monitored. (String: $uuid) |
|
|
meta
|
label |
Titel of the AMS. (String, max. 8 char) |
|
subtitle |
Subtitle of the AMS. (String, max. 16 char) |
|
|
color |
AMS-Farbe (SandyBrown, UnmellowYellow, MediumSpringBud, Inchworm, ScreaminGreen, MintGreen, Aquamarine, ElectricBlue, MayaBlue, MediumSlateBlue, BrightLavender, Heliotrope, PaleMagenta, HotPink, Timberwolf) |
|
|
function
|
solo |
Allows/denise the solo function for this audio source. (Forbidden, Allowed) |
|
isolate |
Allows/denies stereo audio sources to isolate the left/right audio channel. (Forbidden, Allowed) |
|
|
audioFormat |
(Mono, Stereo) |
|
/audio-monitoring-sources
|
leg
|
sourceType |
Select whether the audio source is configured manually (or via SDP) or via NMOS. (Manual, NMOS) |
|||
|
stream
|
playMode |
(Synton, Synchron) |
|||
|
receiverId |
(String: $uuid) |
||||
|
receiveBufferFactor |
Selection of the size of the receive buffer to compensate for runtime differences of the streams. (3 ... 8 ... 112) |
||||
|
channel
|
streamChannelIndex |
(Integer) |
|||
|
legRole |
(Mono, Left, Right) |
||||
|
sdp
|
transport |
sourceAddress |
(String: $ipv4) |
||
|
sourcePort |
(1024 ... 1024 ... 65535) |
||||
|
destinationAddress |
(String: $ipv4) |
||||
|
destinationPort |
(1024 ... 1024 ... 65535) |
||||
|
audio |
numberOfChannels |
(Integer, min.:1) |
|||
|
sampleRate |
(Unknown, RATE_44_1_KHz, RATE_48_KHz, RATE_96_KHz) |
||||
|
pTime |
Packet time is the real-time duration of media data in a packet. (Unknown, P_TIME_0_125, P_TIME_0_25, P_TIME_0_333, P_TIME_0_5, P_TIME_1, P_TIME_1_333, P_TIME_4) |
||||
|
payloadType |
Selection of the Payload type. (96 ... 127) |
||||
|
mediaClockOffset |
Selection of the Time Stamp Offset. (0 ... 65535 ms) |
||||
|
codecType |
Selection of the resolution. (Unknown, L16, L24) |
||||
/key-mapping
|
keyAddress |
keyBlock |
(1 ... 2) |
|
keyAddress |
key |
(1 ... 8) |
|
amsId |
(String: $uuid) |
|
Examples
Example "NMOS Mono Single Source"
|
{ "audioFormat": "Mono", "functionBehavior": { "isolate": "Allowed", "solo": "Allowed" }, "id": "dda5ab80-f279-455a-a227-216a6afdc67d", "legInformation": { "sourceType": "NMOS", "streamChannels": [ { "playMode": "Synchron", "receiveBufferFactor": 8, "receiverId": "2bd3d5db-7628-4c3e-9c4a-8db2158e228f" } ] }, "metaInformation": { "color": "SandyBrown", "label": "AMS", "subtitle": "NMOS" } } |
Example "NMOS Stereo Dual Source"
|
{ "audioFormat": "Stereo", "functionBehavior": { "isolate": "Allowed", "solo": "Allowed" }, "id": "c6e6f7e7-f8c8-4a0b-bfc5-42c871e61e74", "legInformation": { "sourceType": "NMOS", "streamChannels": [ { "playMode": "Synchron", "receiveBufferFactor": 8, "receiverId": "e362c345-411d-4475-9876-dffa3a79dbf3" }, { "playMode": "Synchron", "receiveBufferFactor": 8, "receiverId": "540b2a0e-d198-4459-9da0-612c9deff0b7" } ] }, "metaInformation": { "color": "SandyBrown", "label": "AMS 2", "subtitle": "NMOS" } } |
Example "SDP Stereo Dual Source"
|
{ "audioFormat": "Stereo", "functionBehavior": { "isolate": "Allowed", "solo": "Allowed" }, "id": "e37d8908-f88c-4821-b5a8-35dd67c41a16", "legInformation": { "sourceType": "SDP", "streamChannels": [ { "channelSelection": [ { "legRole": "Left", "streamChannelIndex": 4 }, { "legRole": "Right", "streamChannelIndex": 7 } ], "playMode": "Synton", "receiveBufferFactor": 8, "sdpData": { "audio": { "codecType": "L24", "mediaClockOffset": 0, "numberOfChannels": 8, "pTime": "P_TIME_1", "payloadType": 98, "sampleRate": "RATE_48_KHz" }, "transport": [ { "destinationAddress": "239.0.0.2", "destinationPort": 5004, "sourceAddress": "", "sourcePort": 0 } ] } } ] }, "metaInformation": { "color": "SandyBrown", "label": "AMS 16", "subtitle": "" } } |