Packaging task source configuration

Table of contents

  1. Packaging task overview
    1. Encoding/Packaging comparison
    2. Supported input codecs
    3. Supported packaging formats
  2. Packaging task creation
  3. Packaging task configuration when source is produced by COMPANY_NAME live products
    1. Source requirements
    2. Input settings
    3. Video profiles packaging
    4. Audio profiles packaging
  4. Packaging task configuration when source is produced by other live encoder
    1. Source requirements
    2. Input settings
    3. Video profiles packaging
    4. Audio profiles packaging
  5. Troubleshooting
  1. Packaging task overview

  2. Packaging task creation

    1. Click on "Live Tasks" button, select "Tasks Map" in the list and click on "New" button.

    2. Give a name to the task.

    3. Select task in the list. In "Input" panel, set "Input mode" to m-SPTS.
    4. In "Output" panel, set desired output mode.
    5. If "Output mode" is "OTT", select "Packaging mode".
    6. In "Audio" panel, set "Codec" to "Pass-through".
    7. In "Video" panel, set "Codec" to "Pass-through".
  3. Packager task configuration when source is produced by COMPANY_NAME live products

    1. Source requirements

      Follow recommandations as described in "TS Configuration" document (part "Optimal configuration for packaging purposes")
    2. Input settings

      • From "TS input" panel, select desired ethernet interface and configure first source IP address and first UDP port of the SPTSs to package. Set "IP address" and/or "UDP port" incremental mode.

      • From "Input PIDs" panel, select source PIDs.
    3. Video profiles packaging

      • From "Video" panel, configure the GOP size of the source (i.e the period in milliseconds between two IDR frames).
        Source framerate (fps) Source IDR period (s) "GOP Size" value (ms)
        25fps/50fps 1 1000
        25fps/50fps 2 2000
        29,97fps/59,94fps 1 1001
        29,97fps/59,94fps 2 2002
      • From "Video" panel, set the number of video profiles to package.
        • Example

          • If source multicast address is configured to "226.0.8.8", input UDP port is "5004", and "Use Incremental UDP ports" is enabled...
          • ... and if video profiles are 1,2,3,4,5 are enabled
          • Packaging task will process following streams:
            • Profile 1 : 226.0.8.8:5004
            • Profile 2 : 226.0.8.8:5005
            • Profile 3 : 226.0.8.8:5006
            • Profile 4 : 226.0.8.8:5007
            • Profile 5 : 226.0.8.8:5008
    4. Audio profiles packaging

      From "Audio" panel, enable one audio profile and set "Codec" to "Pass-through".
      Set the number of source audio tracks to package ("all" or by "audio source" index).
      • Example

        • If two "Audio PIDs To Convert" tracks are enabled in "Input PIDs" panel...
        • ... and "Audio input tracks to process" is set to "All inputs", all source audio PIDs (50 and 51) are processed.
        • ... or "Audio input tracks to process" is set to "Some inputs" and input track index is "2", only PID 51 is processed.
  4. Packager channel configuration when source is produced by other live encoder

    1. Source requirements :

      • Transport constraints

        • Each input multirate service shall be:
          • an IP-encapsulated multi-bitrate Single Program Transport Streams (mSPTS), with a maximum 16 video profiles and 32 audio tracks.
          • an IP-encapsulated Multiple Program Transport Streams (MPTS), with a maximum 16 video profiles and 32 audio tracks.
        • One mSPTS is a series of SPTSs from a same service (same content) encoded at different video bitrates (profiles), published to the same multicast IP address and having increasing UDP port numbers, or on the same UDP port and have increasing multicast IP address, or on increasing multicast addresses and UDP port.
        • The SPTS with the lowest IP address/UDP port must carry the audio tracks. SPTSe with higher IP address/UDP port may also carry the same audio tracks.
        • mSPTS/MPTS must contain compliant PAT and PMTs. The packaging starts only once the PAT and all the PMT it describes are received.
        • mSPTS/MPTS carrying the profiles must be GOP aligned one to each other. A GOP must start with an IDR picture.
        • mSPTS video PID number must be identical across profiles.
        • mSPTS/MPTS must carry an H.264/HEVC ES.
        • If AAC audio in present, AAC descriptor must be present in the PMT.
        • The input mSPTS/MPTS service's PAT + PMT structure shall never change: there shall not be any change in the incoming service description, such as: PID changes, codec or resolution changes, audio format changes, audio or video or text or other data tracks appearing or disappearing, or any other change.
        • The maximum network input jitter shall be 10 ms.
        • The bitrate of each H.264 and AAC PID may be signaled in the Harmonic specific H.264/AAC descriptor.
          • If this descriptor is not present, the user will have to manually configure the packager's "input bitrate" setting for that audio or video profile.
          • If present, that value is used by the packager to automatically configure its "input bitrate" setting for that audio or video profile, overriding any manual setting.
      • PES constraints

        • The bitrate of each video and audio Elementary Streams may be signaled in the ES_rate field in the PES header.
          • If this field is not present, the user will have to manually configure the packager’s “input bitrate” setting for that audio or video profile.
          • If present, that field’s value is used by the packager to automatically configure its “input bitrate” setting for that audio or video profile, overriding any manual setting.
      • ES constraints

        • The ES shall contain exactly one SPS (Sequence Parameter Set) and exactly one PPS (Picture Parameter Set), and they shall never change. The reason is that most OTT format do not allow changing SPSes or PPSes.
        Syntax element Mandatory value
        One SPS shall be sent before each access point
        In seq_parameter_set_rbsp:
        vui_parameters_present_flag 1
        In vui_parameters:
        timing_info_present_flag 1
        num_units_in_tick 1
        time_scale
        fixed_frame_rate_flag 1
    2. Input settings

      • m-SPTS source

        • Set "Input mode" to "m-SPTS".
          In "TS input" panel, select desired ethernet interface and configure first source IP address and first UDP port of the SPTSs to package. Set "IP address" and/or "UDP port" incremental mode.

        • From "Input PIDs" panel, select source PIDs.
      • MPTS source

        • Set "Input mode" to "MPTS".
          From "TS input" panel, select desired ethernet interface and configure source IP address and UDP port.

        • From "Input PIDs" panel, set "PID selection mode" to "Manual" and configure PIDs to process.

    3. Video profiles packaging

      • From "Video" panel, configure the GOP size of the source (i.e the period in milliseconds between two IDR frames).
        Source framerate (fps) Source IDR period (s) "GOP Size" value (ms)
        25fps/50fps 1 1000
        25fps/50fps 2 2000
        29,97fps/59,94fps 1 1001
        29,97fps/59,94fps 2 2002
      • From "Video" panel, set the number of video profiles to package.
        If ES_rate is not signaled in PES header of if Harmonic specific H.264 descriptor is not present in source, for each video profile, enable "Signal custom bitrate" and set source video bitrate in kbps.
    4. Audio profiles packaging

      • Source audio contains ES_rate in PES header or Harmonic specific AAC descriptor

        Configure one audio profile and set "Mode" to "All inputs".
      • Source audio does not contain ES_rate in PES header nor Harmonic specific AAC sdescriptor

        From "Audio" panel, select the number of audio profiles to package (i.e the number of "Audio PIDs to convert" configured in "Input PIDs" panel).
        For each audio profile, set "Codec" to "Pass-through", enable "Signal custom bitrate" and set audio track bitrate.
        For each audio profile, set input audio track number to map to the audio profile.
        • Example
          • If two "Audio PIDs To Convert" tracks are enabled in "Input PIDs" panel...
          • ... set "Input Track Index" of audio profile 1 to "1"...

            ... and "Input Track Index" of audio profile 2 to "2"
  5. Troubleshooting