@norskvideo/norsk-api 0.0.329 → 0.0.330

package/lib/media_grpc_pb.js

@@ -271,6 +271,50 @@ function deserialize_norsk_api_media_ChaosMonkeyMessage(buffer_arg) {
   return media_pb.ChaosMonkeyMessage.fromBinary(new Uint8Array(buffer_arg));
 }
 
+function serialize_norsk_api_media_CmafAudioMessage(arg) {
+  if (!(arg instanceof media_pb.CmafAudioMessage)) {
+    throw new Error('Expected argument of type norsk.api.media.CmafAudioMessage');
+  }
+  return Buffer.from(arg.toBinary());
+}
+
+function deserialize_norsk_api_media_CmafAudioMessage(buffer_arg) {
+  return media_pb.CmafAudioMessage.fromBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_norsk_api_media_CmafMasterMessage(arg) {
+  if (!(arg instanceof media_pb.CmafMasterMessage)) {
+    throw new Error('Expected argument of type norsk.api.media.CmafMasterMessage');
+  }
+  return Buffer.from(arg.toBinary());
+}
+
+function deserialize_norsk_api_media_CmafMasterMessage(buffer_arg) {
+  return media_pb.CmafMasterMessage.fromBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_norsk_api_media_CmafVideoMessage(arg) {
+  if (!(arg instanceof media_pb.CmafVideoMessage)) {
+    throw new Error('Expected argument of type norsk.api.media.CmafVideoMessage');
+  }
+  return Buffer.from(arg.toBinary());
+}
+
+function deserialize_norsk_api_media_CmafVideoMessage(buffer_arg) {
+  return media_pb.CmafVideoMessage.fromBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_norsk_api_media_CmafWebVttMessage(arg) {
+  if (!(arg instanceof media_pb.CmafWebVttMessage)) {
+    throw new Error('Expected argument of type norsk.api.media.CmafWebVttMessage');
+  }
+  return Buffer.from(arg.toBinary());
+}
+
+function deserialize_norsk_api_media_CmafWebVttMessage(buffer_arg) {
+  return media_pb.CmafWebVttMessage.fromBinary(new Uint8Array(buffer_arg));
+}
+
 function serialize_norsk_api_media_ComposeVideoMessage(arg) {
   if (!(arg instanceof media_pb.ComposeVideoMessage)) {
     throw new Error('Expected argument of type norsk.api.media.ComposeVideoMessage');
@@ -370,28 +414,6 @@ function deserialize_norsk_api_media_Hardware(buffer_arg) {
   return media_pb.Hardware.fromBinary(new Uint8Array(buffer_arg));
 }
 
-function serialize_norsk_api_media_HlsAudioMessage(arg) {
-  if (!(arg instanceof media_pb.HlsAudioMessage)) {
-    throw new Error('Expected argument of type norsk.api.media.HlsAudioMessage');
-  }
-  return Buffer.from(arg.toBinary());
-}
-
-function deserialize_norsk_api_media_HlsAudioMessage(buffer_arg) {
-  return media_pb.HlsAudioMessage.fromBinary(new Uint8Array(buffer_arg));
-}
-
-function serialize_norsk_api_media_HlsMasterMessage(arg) {
-  if (!(arg instanceof media_pb.HlsMasterMessage)) {
-    throw new Error('Expected argument of type norsk.api.media.HlsMasterMessage');
-  }
-  return Buffer.from(arg.toBinary());
-}
-
-function deserialize_norsk_api_media_HlsMasterMessage(buffer_arg) {
-  return media_pb.HlsMasterMessage.fromBinary(new Uint8Array(buffer_arg));
-}
-
 function serialize_norsk_api_media_HlsMasterPushMessage(arg) {
   if (!(arg instanceof media_pb.HlsMasterPushMessage)) {
     throw new Error('Expected argument of type norsk.api.media.HlsMasterPushMessage');
@@ -469,28 +491,6 @@ function deserialize_norsk_api_media_HlsTsVideoPushMessage(buffer_arg) {
   return media_pb.HlsTsVideoPushMessage.fromBinary(new Uint8Array(buffer_arg));
 }
 
-function serialize_norsk_api_media_HlsVideoMessage(arg) {
-  if (!(arg instanceof media_pb.HlsVideoMessage)) {
-    throw new Error('Expected argument of type norsk.api.media.HlsVideoMessage');
-  }
-  return Buffer.from(arg.toBinary());
-}
-
-function deserialize_norsk_api_media_HlsVideoMessage(buffer_arg) {
-  return media_pb.HlsVideoMessage.fromBinary(new Uint8Array(buffer_arg));
-}
-
-function serialize_norsk_api_media_HlsWebVttMessage(arg) {
-  if (!(arg instanceof media_pb.HlsWebVttMessage)) {
-    throw new Error('Expected argument of type norsk.api.media.HlsWebVttMessage');
-  }
-  return Buffer.from(arg.toBinary());
-}
-
-function deserialize_norsk_api_media_HlsWebVttMessage(buffer_arg) {
-  return media_pb.HlsWebVttMessage.fromBinary(new Uint8Array(buffer_arg));
-}
-
 function serialize_norsk_api_media_HlsWebVttPushMessage(arg) {
   if (!(arg instanceof media_pb.HlsWebVttPushMessage)) {
     throw new Error('Expected argument of type norsk.api.media.HlsWebVttPushMessage');
@@ -1109,15 +1109,15 @@ var MediaService = exports.MediaService = {
     responseSerialize: serialize_norsk_api_media_WebVttFileInputEvent,
     responseDeserialize: deserialize_norsk_api_media_WebVttFileInputEvent,
   },
-  // *
+  //
 // Creates an RTMP ingest Media Node.  On creation, the Media Node is idle
-// and your code <b>must</b> send an <ref>RtmpInputConfiguration</ref>
+// and your code **must** send an `RtmpInputConfiguration`
 // message to configure the RTMP server.  When a remote client connects, an
-// <ref>RtmpConnection</ref> message is sent, which the code can choose to
-// accept &ndash; by sending an <ref>RtmpConnectionAccept</ref> message or
-// reject &ndash; by sending an <ref>RtmpConnectionReject</ref> message.
+// `RtmpConnection` message is sent, which the code can choose to
+// accept &ndash; by sending an `RtmpConnectionAccept` message or
+// reject &ndash; by sending an `RtmpConnectionReject` message.
 // Once a connection is established, Norsk will continue to send appropriate
-// <ref>RtmpInputEvent</ref> messages as events occur.
+// `RtmpInputEvent` messages as events occur.
 createRtmpInput: {
     path: '/norsk.api.media.Media/CreateRtmpInput',
     requestStream: true,
@@ -1129,7 +1129,9 @@ createRtmpInput: {
     responseSerialize: serialize_norsk_api_media_RtmpInputEvent,
     responseDeserialize: deserialize_norsk_api_media_RtmpInputEvent,
   },
-  createTsFileInput: {
+  // *
+// Read from a Transport Stream file with realtime playback.
+createTsFileInput: {
     path: '/norsk.api.media.Media/CreateTsFileInput',
     requestStream: true,
     responseStream: true,
@@ -1151,7 +1153,16 @@ createRtmpInput: {
     responseSerialize: serialize_norsk_api_media_TestCardVideoGeneratorEvent,
     responseDeserialize: deserialize_norsk_api_media_TestCardVideoGeneratorEvent,
   },
-  createDeckLinkInput: {
+  // *
+// SDI/HDMI Input using a BlackMagic DeckLink card.
+// The available cards on the machine can be enumerated using the
+// `HardwareInfo` rpc.
+//
+// Multiple cards and both SDI and HDMI inputs are supported, with all DeckLink-supported
+// input resolutions and framerates are supported.  The capture format is currently 8-bit only,
+// but 10-bit captures will be supported soon.  All supported audio channels can be captured.
+// At present, additional data such as closed-captions and HDR metadata is not captured.
+createDeckLinkInput: {
     path: '/norsk.api.media.Media/CreateDeckLinkInput',
     requestStream: true,
     responseStream: true,
@@ -1163,7 +1174,8 @@ createRtmpInput: {
     responseDeserialize: deserialize_norsk_api_media_DeckLinkInputEvent,
   },
   // *
-// Creates a video source from a static image file on disk (e.g. PNG, JPEG)
+// Read an image from a file. Various image formats are supported, see the
+// documentation for `ImageFileInputConfiguration` for more details.
 createImageFileInput: {
     path: '/norsk.api.media.Media/CreateImageFileInput',
     requestStream: false,
@@ -1188,7 +1200,9 @@ createMp4FileInput: {
     responseSerialize: serialize_norsk_api_media_Mp4FileInputEvent,
     responseDeserialize: deserialize_norsk_api_media_Mp4FileInputEvent,
   },
-  createAudioSignalGenerator: {
+  // *
+// Generate a test audio signal with a configurable waveform.
+createAudioSignalGenerator: {
     path: '/norsk.api.media.Media/CreateAudioSignalGenerator',
     requestStream: false,
     responseStream: true,
@@ -1199,7 +1213,9 @@ createMp4FileInput: {
     responseSerialize: serialize_norsk_api_media_AudioSignalGeneratorEvent,
     responseDeserialize: deserialize_norsk_api_media_AudioSignalGeneratorEvent,
   },
-  createBrowserInput: {
+  // *
+// Video source from rendering an HTML page
+createBrowserInput: {
     path: '/norsk.api.media.Media/CreateBrowserInput',
     requestStream: true,
     responseStream: true,
@@ -1221,7 +1237,9 @@ createMp4FileInput: {
     responseSerialize: serialize_norsk_api_media_WhipInputEvent,
     responseDeserialize: deserialize_norsk_api_media_WhipInputEvent,
   },
-  createSrtInput: {
+  // *
+// Stream from a SRT source
+createSrtInput: {
     path: '/norsk.api.media.Media/CreateSrtInput',
     requestStream: true,
     responseStream: true,
@@ -1254,7 +1272,15 @@ createMp4FileInput: {
     responseSerialize: serialize_norsk_api_media_TsInputEvent,
     responseDeserialize: deserialize_norsk_api_media_TsInputEvent,
   },
-  createTimestampNudger: {
+  // *
+// A node to nudge the timestamps on a stream, which affects how it syncs
+// with other streams. Useful for correcting for drift between different
+// sources.
+//
+// Subsequent nudges, via the `nudge` method, are applied gradually.
+//
+// This functionality is also provided by a `nudge` method on many sources.
+createTimestampNudger: {
     path: '/norsk.api.media.Media/CreateTimestampNudger',
     requestStream: true,
     responseStream: true,
@@ -1265,7 +1291,9 @@ createMp4FileInput: {
     responseSerialize: serialize_norsk_api_media_TimestampNudgerEvent,
     responseDeserialize: deserialize_norsk_api_media_TimestampNudgerEvent,
   },
-  createVideoEncodeLadder: {
+  // *
+// Encode a video stream to one or more renditions
+createVideoEncodeLadder: {
     path: '/norsk.api.media.Media/CreateVideoEncodeLadder',
     requestStream: true,
     responseStream: true,
@@ -1276,7 +1304,9 @@ createMp4FileInput: {
     responseSerialize: serialize_norsk_api_media_VideoEncodeLadderEvent,
     responseDeserialize: deserialize_norsk_api_media_VideoEncodeLadderEvent,
   },
-  createVideoTransform: {
+  // *
+// Transform a video stream (rescale, etc)
+createVideoTransform: {
     path: '/norsk.api.media.Media/CreateVideoTransform',
     requestStream: true,
     responseStream: true,
@@ -1287,7 +1317,9 @@ createMp4FileInput: {
     responseSerialize: serialize_norsk_api_media_VideoTransformEvent,
     responseDeserialize: deserialize_norsk_api_media_VideoTransformEvent,
   },
-  createChaosMonkey: {
+  // *
+// Interferes with a stream by dropping frames
+createChaosMonkey: {
     path: '/norsk.api.media.Media/CreateChaosMonkey',
     requestStream: true,
     responseStream: true,
@@ -1298,7 +1330,9 @@ createMp4FileInput: {
     responseSerialize: serialize_norsk_api_media_ChaosMonkeyEvent,
     responseDeserialize: deserialize_norsk_api_media_ChaosMonkeyEvent,
   },
-  createAudioEncoder: {
+  // *
+// Encode an audio stream.
+createAudioEncoder: {
     path: '/norsk.api.media.Media/CreateAudioEncoder',
     requestStream: true,
     responseStream: true,
@@ -1312,7 +1346,7 @@ createMp4FileInput: {
   // *
 // Create a Media Node composing multiple sources into one, eg to construct
 // overlays, picture-in-picture or split-screen video.
-// <br/><br/>
+//
 // Individual sources may be cropped or scaled as part of this process
 createComposeVideo: {
     path: '/norsk.api.media.Media/CreateComposeVideo',
@@ -1325,7 +1359,10 @@ createComposeVideo: {
     responseSerialize: serialize_norsk_api_media_ComposeVideoSourceEvent,
     responseDeserialize: deserialize_norsk_api_media_ComposeVideoSourceEvent,
   },
-  createAudioMixer: {
+  // *
+// Mix multiple audio streams together into a single output,
+// with optional gain control on each input.
+createAudioMixer: {
     path: '/norsk.api.media.Media/CreateAudioMixer',
     requestStream: true,
     responseStream: true,
@@ -1336,7 +1373,9 @@ createComposeVideo: {
     responseSerialize: serialize_norsk_api_media_AudioMixerEvent,
     responseDeserialize: deserialize_norsk_api_media_AudioMixerEvent,
   },
-  createAudioMatrixMixer: {
+  // *
+// Given an audio stream of N channels, mix it down to M channels through a matrix of NxM gains.
+createAudioMatrixMixer: {
     path: '/norsk.api.media.Media/CreateAudioMatrixMixer',
     requestStream: true,
     responseStream: true,
@@ -1347,7 +1386,9 @@ createComposeVideo: {
     responseSerialize: serialize_norsk_api_media_AudioMatrixMixerEvent,
     responseDeserialize: deserialize_norsk_api_media_AudioMatrixMixerEvent,
   },
-  createAudioGain: {
+  // *
+// Apply gain to an audio stream
+createAudioGain: {
     path: '/norsk.api.media.Media/CreateAudioGain',
     requestStream: true,
     responseStream: true,
@@ -1358,7 +1399,12 @@ createComposeVideo: {
     responseSerialize: serialize_norsk_api_media_AudioGainEvent,
     responseDeserialize: deserialize_norsk_api_media_AudioGainEvent,
   },
-  createAudioBuildMultichannel: {
+  // *
+// Aggregate many single-channel audio streams into a stream with the
+// specified channel layout. The streams must all have the same sample format
+// and sample rate. The order of the streams provided for the channels is
+// important.
+createAudioBuildMultichannel: {
     path: '/norsk.api.media.Media/CreateAudioBuildMultichannel',
     requestStream: true,
     responseStream: true,
@@ -1369,7 +1415,11 @@ createComposeVideo: {
     responseSerialize: serialize_norsk_api_media_AudioBuildMultichannelEvent,
     responseDeserialize: deserialize_norsk_api_media_AudioBuildMultichannelEvent,
   },
-  createAudioSplitMultichannel: {
+  // *
+// Split a multichannel audio stream into its individual channels. The first
+// channel receives the specified stream key, and each subsequent channel
+// increments the stream id on the stream key.
+createAudioSplitMultichannel: {
     path: '/norsk.api.media.Media/CreateAudioSplitMultichannel',
     requestStream: true,
     responseStream: true,
@@ -1394,14 +1444,14 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_AwsTranscribeEvent,
     responseDeserialize: deserialize_norsk_api_media_AwsTranscribeEvent,
   },
-  createHlsVideoOutput: {
-    path: '/norsk.api.media.Media/CreateHlsVideoOutput',
+  createCmafVideoOutput: {
+    path: '/norsk.api.media.Media/CreateCmafVideoOutput',
     requestStream: true,
     responseStream: true,
-    requestType: media_pb.HlsVideoMessage,
+    requestType: media_pb.CmafVideoMessage,
     responseType: media_pb.HlsOutputEvent,
-    requestSerialize: serialize_norsk_api_media_HlsVideoMessage,
-    requestDeserialize: deserialize_norsk_api_media_HlsVideoMessage,
+    requestSerialize: serialize_norsk_api_media_CmafVideoMessage,
+    requestDeserialize: deserialize_norsk_api_media_CmafVideoMessage,
     responseSerialize: serialize_norsk_api_media_HlsOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_HlsOutputEvent,
   },
@@ -1427,14 +1477,14 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_HlsOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_HlsOutputEvent,
   },
-  createHlsAudioOutput: {
-    path: '/norsk.api.media.Media/CreateHlsAudioOutput',
+  createCmafAudioOutput: {
+    path: '/norsk.api.media.Media/CreateCmafAudioOutput',
     requestStream: true,
     responseStream: true,
-    requestType: media_pb.HlsAudioMessage,
+    requestType: media_pb.CmafAudioMessage,
     responseType: media_pb.HlsOutputEvent,
-    requestSerialize: serialize_norsk_api_media_HlsAudioMessage,
-    requestDeserialize: deserialize_norsk_api_media_HlsAudioMessage,
+    requestSerialize: serialize_norsk_api_media_CmafAudioMessage,
+    requestDeserialize: deserialize_norsk_api_media_CmafAudioMessage,
     responseSerialize: serialize_norsk_api_media_HlsOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_HlsOutputEvent,
   },
@@ -1449,14 +1499,14 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_HlsOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_HlsOutputEvent,
   },
-  createHlsWebVttOutput: {
-    path: '/norsk.api.media.Media/CreateHlsWebVttOutput',
+  createCmafWebVttOutput: {
+    path: '/norsk.api.media.Media/CreateCmafWebVttOutput',
     requestStream: true,
     responseStream: true,
-    requestType: media_pb.HlsWebVttMessage,
+    requestType: media_pb.CmafWebVttMessage,
     responseType: media_pb.HlsOutputEvent,
-    requestSerialize: serialize_norsk_api_media_HlsWebVttMessage,
-    requestDeserialize: deserialize_norsk_api_media_HlsWebVttMessage,
+    requestSerialize: serialize_norsk_api_media_CmafWebVttMessage,
+    requestDeserialize: deserialize_norsk_api_media_CmafWebVttMessage,
     responseSerialize: serialize_norsk_api_media_HlsOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_HlsOutputEvent,
   },
@@ -1493,14 +1543,14 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_HlsOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_HlsOutputEvent,
   },
-  createHlsMasterOutput: {
-    path: '/norsk.api.media.Media/CreateHlsMasterOutput',
+  createCmafMasterOutput: {
+    path: '/norsk.api.media.Media/CreateCmafMasterOutput',
     requestStream: true,
     responseStream: true,
-    requestType: media_pb.HlsMasterMessage,
+    requestType: media_pb.CmafMasterMessage,
     responseType: media_pb.HlsOutputEvent,
-    requestSerialize: serialize_norsk_api_media_HlsMasterMessage,
-    requestDeserialize: deserialize_norsk_api_media_HlsMasterMessage,
+    requestSerialize: serialize_norsk_api_media_CmafMasterMessage,
+    requestDeserialize: deserialize_norsk_api_media_CmafMasterMessage,
     responseSerialize: serialize_norsk_api_media_HlsOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_HlsOutputEvent,
   },
@@ -1515,7 +1565,12 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_HlsOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_HlsOutputEvent,
   },
-  createLocalWebRTCOutput: {
+  // *
+// Playback audio/video via webrtc to a browser, and accept audio/video input from a browser.
+// The browser client must conform to a custom protocol as implemented in the hosted test page.
+// For general WebRTC ingest prefer the WHIP input node, and for egest to a downstream media server
+// use the WHIP output node.
+createLocalWebRTCOutput: {
     path: '/norsk.api.media.Media/CreateLocalWebRTCOutput',
     requestStream: true,
     responseStream: true,
@@ -1570,7 +1625,9 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_RtmpOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_RtmpOutputEvent,
   },
-  createTsFileOutput: {
+  // *
+// Stream to a Transport Stream file.
+createTsFileOutput: {
     path: '/norsk.api.media.Media/CreateTsFileOutput',
     requestStream: true,
     responseStream: true,
@@ -1581,7 +1638,21 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_TsFileOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_TsFileOutputEvent,
   },
-  createMp4FileOutput: {
+  // *
+// Output MP4 files to disk, both fragmented and non-fragmented.
+//
+// The fragmented output is required.
+//
+// The optional non-fragmented filename will be written after sending
+// the `close` message and will be fully written by the time the node is
+// closed. This sets up a temp file to store the frame data by appending
+// the extension `.tmp`.
+//
+// A non-fragmented MP4 file can be written on request with the
+// `write_file` message, which uses the frame data store if
+// `nonfragmented_file_name` was given or reads
+// back the fragmented mp4 if there is no non-fragmented file.
+createMp4FileOutput: {
     path: '/norsk.api.media.Media/CreateMp4FileOutput',
     requestStream: true,
     responseStream: true,
@@ -1592,7 +1663,10 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_Mp4FileOutputEvent,
     responseDeserialize: deserialize_norsk_api_media_Mp4FileOutputEvent,
   },
-  createHardSwitcher: {
+  // *
+// Switch between multiple input sources via a hard cut. May be used to switch between
+// sources of possibly different configurations or without decoding.
+createHardSwitcher: {
     path: '/norsk.api.media.Media/CreateHardSwitcher',
     requestStream: true,
     responseStream: true,
@@ -1603,7 +1677,9 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_HardSwitcherEvent,
     responseDeserialize: deserialize_norsk_api_media_HardSwitcherEvent,
   },
-  createSmoothSwitcher: {
+  // *
+// Switch between multiple input sources without interruption, via a transition.
+createSmoothSwitcher: {
     path: '/norsk.api.media.Media/CreateSmoothSwitcher',
     requestStream: true,
     responseStream: true,
@@ -1614,7 +1690,13 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_SmoothSwitcherEvent,
     responseDeserialize: deserialize_norsk_api_media_SmoothSwitcherEvent,
   },
-  createStreamKeyOverride: {
+  // *
+// Provide a new stream key for a single stream. Cannot be subscribed to
+// multiple streams at once.
+//
+// The stream key is used for identifying streams within multiplexed sources
+// and also is translated into URIs for HLS playlists and other resources.
+createStreamKeyOverride: {
     path: '/norsk.api.media.Media/CreateStreamKeyOverride',
     requestStream: true,
     responseStream: true,
@@ -1625,7 +1707,14 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_StreamKeyOverrideEvent,
     responseDeserialize: deserialize_norsk_api_media_StreamKeyOverrideEvent,
   },
-  createMetadataOverride: {
+  // *
+// Override bitrate and language metadata on streams.
+//
+// Audio and video bitrate metadata is required for playlists for both
+// `CreateHlsMasterOutput` and `CreateHlsMasterPushOutput`
+// nodes. It is automatically configured for some sources (like RTMP) and in
+// cases where re-encoding is done, but is unset for other sources (like SRT).
+createMetadataOverride: {
     path: '/norsk.api.media.Media/CreateMetadataOverride',
     requestStream: true,
     responseStream: true,
@@ -1636,7 +1725,11 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_MetadataOverrideEvent,
     responseDeserialize: deserialize_norsk_api_media_MetadataOverrideEvent,
   },
-  createSync: {
+  // *
+// Sync multiple streams together by timestamps, queuing frames from streams
+// that are behind the others. This is already included in most nodes,
+// especially outputs.
+createSync: {
     path: '/norsk.api.media.Media/CreateSync',
     requestStream: true,
     responseStream: true,
@@ -1647,7 +1740,13 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_SyncEvent,
     responseDeserialize: deserialize_norsk_api_media_SyncEvent,
   },
-  createStreamStats: {
+  // *
+// Record statistical information about media streams, including bitrate,
+// frame rate, and number of keyframes, measured over some configurable
+// sampling windows.
+//
+// Corresponding settings are found on many input and output nodes.
+createStreamStats: {
     path: '/norsk.api.media.Media/CreateStreamStats',
     requestStream: true,
     responseStream: true,
@@ -1658,7 +1757,9 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_StreamStatsEvent,
     responseDeserialize: deserialize_norsk_api_media_StreamStatsEvent,
   },
-  createAudioLevels: {
+  // *
+// Monitor the volume of an audio stream
+createAudioLevels: {
     path: '/norsk.api.media.Media/CreateAudioLevels',
     requestStream: true,
     responseStream: true,
@@ -1669,7 +1770,9 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_AudioLevelsEvent,
     responseDeserialize: deserialize_norsk_api_media_AudioLevelsEvent,
   },
-  createRtpInput: {
+  // *
+// Stream from a remote RTP source
+createRtpInput: {
     path: '/norsk.api.media.Media/CreateRtpInput',
     requestStream: true,
     responseStream: true,
@@ -1680,7 +1783,9 @@ createAwsTranscribe: {
     responseSerialize: serialize_norsk_api_media_RtpInputEvent,
     responseDeserialize: deserialize_norsk_api_media_RtpInputEvent,
   },
-  hardwareInfo: {
+  // *
+// Query information about the hardware Norsk is running on.
+hardwareInfo: {
     path: '/norsk.api.media.Media/HardwareInfo',
     requestStream: false,
     responseStream: false,