Media Address Format
In Astra, the media source or destination is described using a media address that resembles a typical URL. This format makes it easy to understand and work with the different components involved in managing media streams.
Understanding the Media Address Format
Section titled “Understanding the Media Address Format”The media address format consists of three main components: type, address, and options. It follows the structure:
type://address#optionstype: represents the protocol or method used for receiving or transmitting media streamsaddress: is a type-specific string that indicates the source or destination of the media stream. This can vary depending on the protocol being usedoptions: protocol-specific and general settings that affect the behavior of the media stream. Options are separated by an ’&’ symbol
Example of a complete media address:
dvb://a001#pnr=100&camIn this example:
dvb: is the type, indicating that the media source is a DVB Adaptera001: is the DVB Adapter identifier, specifying the specific adapter to be usedpnr=100: option to select the program number 100 from the streamcam: option to enable CAM (Conditional Access Module) for decrypting the stream
Let’s take a closer look at each of these components and their respective roles in the address format.
Receiving Media Types
Section titled “Receiving Media Types”dvb: media source received via a DVB Tuner or Virtual adapter. Introduction to DVB Adapter Tuningudp: UDP multicast or unicastrtp: RTP multicast or unicasthttp: HTTP based protocols: HTTP MPEG-TS or HLSsrt: SRT protocolrtsp: RTSP protocol, commonly used to receive stream from IP camera streamsfile: MPEG-TS file on the server
Transmitting Media Types
Section titled “Transmitting Media Types”udp: UDP multicast or unicastrtp: RTP multicast or unicastsrt: SRT protocolhttp: HTTP based protocols, by the default HTTP MPEG-TS, or HLS if media address ends with.m3u8extensionresi: DVB-C modulator by DigitalDevicestbs: DVB-C modulator by TBSit950x: DVB-T modulator by HiDesfile: save stream to the MPEG-TS file, or directory on the servernp: (NetworkPush) the HTTP-based protocol, used to send streams from Astra to the remote server
Type-Specific Addresses
Section titled “Type-Specific Addresses”In the media address format, the type-specific address component determines the source or destination of the media stream based on the chosen protocol. To learn more about the address formats for each media type, please refer to the article links above.
Introduction to General Input Options
Section titled “Introduction to General Input Options”General input options play a critical role in fine-tuning the receiving and processing of media streams. These options allow you to modify various parameters that affect the behavior of the media stream, such as filtering, analyzing, and modifying.
Most common options:
pnr=PNR: the program number/SID (Service ID) retrieves the channel with the specified number from the stream. Read more in MPEG-TS Demultiplexingset_pnr=PNR: to change PNR. The value must be between 1 and 65535filter=N,...: stream filtration, used to remove the specified PID. Identifiers are separated by commas. Read more in Filtering Stream PIDsfilter~=N,...: stream filtering, used to remove all data except specified PID and service tables. Identifiers are separated by commasorder: sort PID in the PMT table. Often used with the lang parameter to select a priority audio track. Read more in Reorder audio streamslang: set the language code for the audio track. Example:lang.1241=engwhere:1241- pid,eng- language code
Other options:
set_tsid=TSID: to change TSID (Transport Stream ID)biss=1122330044556600: use BISS key for decrypting stream. Read more: Decrypt streams with BISS CAScam: use DVB-CI for decrypting streamcam=CAM-ID: use CAM Client for decrypting streamecm_pid=PID: define ECM PID for CAM Client (not recommended)cas: skip service data about conditional access systems. Used to transmit an encrypted streammap.SRC=DST: change PID to the specified values. SRC - the original identifier or data type. Possible types: pmt, video, audio, ait, language code. DST - required identifier. The value can be between 32 and 8190. Read more in Remapping Stream PIDsno_sdt: to delete channel information: channel name, operator name (SDT Service Description Table)pass_sdt: SDT transfer without processing. By default, if pnr is set, Astra transmits information only on the selected streamno_eit: delete EPG event information (EIT - Event Information Table)pass_eit: EIT transmission without processing. By default, if pnr is set, Astra transmits information only on the selected streamno_analyze: disables checking for changes in the streamcc_limit=N: set CC error limit. If the number of CC errors exceeds the set limit, Astra will switch to the backup source (if available). Default: no limit is setbitrate_limit=RATE: set the minimum bitrate for the analyzer in Kbit/s. The source will be considered non-working if the stream bitrate is less than the specified value. Default:16 Kbit/sfor stream without video data and128 Kbit/sfor stream with video datapass_data: retain packets with the private data (data-pid). Read more in MPEG-TS Demultiplexing