Skip to content

Latest commit

 

History

History
365 lines (274 loc) · 9.07 KB

dash.md

File metadata and controls

365 lines (274 loc) · 9.07 KB

Dash SCTE-35 Parser Preview (Updated 11/26/2024)

The cli also has XML support

From Xml

SCTE-35 XML is converted to a threefive.Cue instance.

Usage:

  • Use a Cue instance.
  from threefive import Cue
  cue=Cue(dash_xml)           # Create a Cue instance
  cue.show()
Example #1
  • "urn:scte:scte35:2013:xml"
  • A DASH SCTE-35 Event converted to a Cue instance.
Xml 
some_xml = """<Event duration="5310000">
            <SpliceInfoSection protocolVersion="0" ptsAdjustment="183003" tier="4095" xmlns="http://www.scte.org/schemas/35">
            <TimeSignal>
                <SpliceTime ptsTime="3442857000"/>
            </TimeSignal>
            <SegmentationDescriptor segmentationEventId="1414668"
                segmentationEventCancelIndicator="false" segmentationDuration="8100000"
                segmentationTypeId="52" segmentNum="0" segmentsExpected="0">
            <DeliveryRestrictions webDeliveryAllowedFlag="false"
                noRegionalBlackoutFlag="false" archiveAllowedFlag="false"
                deviceRestrictions="3"/>
            <SegmentationUpid segmentationUpidType="8"
                segmentationUpidLength="8">0x2df3aad7</SegmentationUpid>
            </SegmentationDescriptor>
            </SpliceInfoSection>
        </Event>
        """
Code 
from threefive import Cue

cue = Cue(some_xml)
cue.show()
  • You can edit the cue and re-encode:
>>>> cue.command.pts_time
38253.966667
>>>> cue.command.pts_time=1234.567890
>>>> cue.encode()
'/DAxAAAAAsrbAP/wBQb+Bp9rxgAbAhlDVUVJABWWDH+DCAgAAAAALfOq1zQAAAAAtBIUqg=='  #    <-- Base64
>>>> print(cue.xml(xmlbin=False))
<SpliceInfoSection xmlns="https://scte.org/schemas/35" ptsAdjustment="183003" protocolVersion="0" sapType="3" tier="4095">
   <TimeSignal>
      <SpliceTime ptsTime="111111110"/> # <--- this is in ticks, that's 1234.567890 seconds
   </TimeSignal>
   <!-- Provider Placement Opportunity Start -->
   <SegmentationDescriptor segmentationEventId="1414668" segmentationEventCancelIndicator="false" segmentationEventIdComplianceIndicator="true" segmentationTypeId="52" segmentNum="0" segmentsExpected="0" subSegmentNum="0" subSegmentsExpected="0">
      <DeliveryRestrictions webDeliveryAllowedFlag="false" noRegionalBlackoutFlag="false" archiveAllowedFlag="false" deviceRestrictions="3"/>
      <!-- UPID: AiringID -->
      <SegmentationUpid segmentationUpidType="8" segmentationUpidFormat="hexbinary">0x2df3aad7</SegmentationUpid>
   </SegmentationDescriptor>
</SpliceInfoSection>
The Cue after calling load() 
{
    "info_section": {
        "table_id": "0xfc",
        "section_syntax_indicator": false,
        "private": false,
        "sap_type": "0x03",
        "sap_details": "No Sap Type",
        "section_length": 54,
        "protocol_version": 0,
        "encrypted_packet": false,
        "encryption_algorithm": 0,
        "pts_adjustment": 2.033367,
        "cw_index": "0x0",
        "tier": "0xfff",
        "splice_command_length": 5,
        "splice_command_type": 6,
        "descriptor_loop_length": 32,
        "crc": "0x8926251d"
    },
    "command": {
        "command_length": 5,
        "command_type": 6,
        "name": "Time Signal",
        "time_specified_flag": true,
        "pts_time": 38253.966667
    },
    "descriptors": [
        {
            "tag": 2,
            "descriptor_length": 30,
            "name": "Segmentation Descriptor",
            "identifier": "CUEI",
            "segmentation_event_id": "0x15960c",
            "segmentation_event_cancel_indicator": false,
            "segmentation_event_id_compliance_indicator": true,
            "program_segmentation_flag": true,
            "segmentation_duration_flag": true,
            "delivery_not_restricted_flag": false,
            "web_delivery_allowed_flag": false,
            "no_regional_blackout_flag": false,
            "archive_allowed_flag": false,
            "device_restrictions": "No Restrictions",
            "segmentation_duration": 90.0,
            "segmentation_upid_type": 8,
            "segmentation_upid_length": 8,
            "segmentation_upid": "0x2df3aad7",
            "segmentation_type_id": 52,
            "segment_num": 0,
            "segments_expected": 0,
            "sub_segment_num": 0,
            "sub_segments_expected": 0
        }
    ],
    "dash_data": {             # dash_data includes EventStream, Event,
        "Event": {             # and Signal node data when present.
            "duration": 59.0
        }
    }
}

a@fu:~$

Example #2

  • "urn:scte:scte35:2014:xml+bin"
  • SCTE-35 Base64 in Xml converted to a threefive.Cue instance.
Xml 
some_xml = """<Event
        presentationTime="1725944855040"
        duration="38400"
        id="14268724">
        <Signal
          xmlns="http://www.scte.org/schemas/35/2016">
          <Binary>/DAgAAAAAAAAAP/wDwUA2bk0f//+ADS8AMAAAAAAAORhJCQ=</Binary>
        </Signal>
      </Event>"""
Code 
from threefive import Cue

cue = Cue(some_xml)
cue.show()
The Cue after calling load() 
{
{
    "info_section": {
        "table_id": "0xfc",
        "section_syntax_indicator": false,
        "private": false,
        "sap_type": "0x03",
        "sap_details": "No Sap Type",
        "section_length": 32,
        "protocol_version": 0,
        "encrypted_packet": false,
        "encryption_algorithm": 0,
        "pts_adjustment": 0.0,
        "cw_index": "0x00",
        "tier": "0x0fff",
        "splice_command_length": 15,
        "splice_command_type": 5,
        "descriptor_loop_length": 0,
        "crc": "0xe4612424"
    },
    "command": {
        "command_length": 15,
        "command_type": 5,
        "name": "Splice Insert",
        "break_auto_return": true,
        "break_duration": 38.4,
        "splice_event_id": 14268724,
        "splice_event_cancel_indicator": false,
        "out_of_network_indicator": true,
        "program_splice_flag": true,
        "duration_flag": true,
        "splice_immediate_flag": true,
        "event_id_compliance_flag": true,
        "unique_program_id": 49152,
        "avail_num": 0,
        "avails_expected": 0
    },
    "descriptors": [],
    "dash_data": {                             # dash_data includes EventStream, Event
        "Event": {                              # and Signal node data when present.
            "presentation_time": 1725944855040,
            "duration": 0.426667,
            "id": 14268724
        },
        "Signal": {
            "xmlns": "http://www.scte.org/schemas/35/2016"
        }
    }
}

To Xml

Convert a threefive.Cue instance to SCTE-35 Xml

Usage:

from threefive import Cue

cue=Cue(data) # Data can be Base64, Bytes, Hex, Integer,Json, or Xml

x = cue.xml(xmlbin=False) # returns a threefive.Node instance
print(x)  # displays xml
Example 3
  • "urn:scte:scte35:2013:xml"
  • Converting a Cue instance to xml for Dash
Base64 
/DA2AAHOR/nwAAAABQb+PnGRBwAgAh5DVUVJSAAAbH/PAAE1ODcICAAAAAAt86rXNAAAAACwnuYL
Code 
from threefive import Cue
cue=Cue('/DA2AAHOR/nwAAAABQb+PnGRBwAgAh5DVUVJSAAAbH/PAAE1ODcICAAAAAAt86rXNAAAAACwnuYL')
cue.decode()
x = cue.xml(xmlbin=False) # returns a threefive.Node instance
print(x)   # displays xml
xml Output 
<SpliceInfoSection ptsAdjustment="7755790832" protocolVersion="0" sapType="3" tier="0" xmlns="http://www.scte.org/schemas/35">
   <TimeSignal>
      <SpliceTime ptsTime="1047630087"/>
   </TimeSignal>
   <SegmentationDescriptor segmentationEventId="1207959660" segmentationEventCancelIndicator="false" segmentationEventIdComplianceIndicator="true" segmentationDuration="20265015" segmentNum="0" segmentsExpected="0" subSegmentNum="0" subSegmentsExpected="0">
      <DeliveryRestrictions webDeliveryAllowedFlag="false" noRegionalBlackoutFlag="true" archiveAllowedFlag="true" deviceRestrictions="3"/>
      <SegmentationUpid segmentationUpidType="8">0x2df3aad7</SegmentationUpid>
   </SegmentationDescriptor>
</SpliceInfoSection>
Example 4
  • "urn:scte:scte35:2014:xml+bin"
  • Converting a Cue instance to xml+binary for Dash
Base64 
'/DAlAAAAAAAAAP/wFAUAAAABf+/+y+LXLv4ARKogAAEAAAAAMZjNOQ=='
Code 
from threefive import Cue
b64 = '/DAlAAAAAAAAAP/wFAUAAAABf+/+y+LXLv4ARKogAAEAAAAAMZjNOQ=='
cue=Cue(b64)
cue.decode()
x = cue.xml() # returns a threefive.Node instance with a Binary Node
print(x)  # displays xml
xml Output 
<Signal xmlns="http://www.scte.org/schemas/35/2016">
    <Binary>/DAlAAAAAAAAAP/wFAUAAAABf+/+y+LXLv4ARKogAAEAAAAAMZjNOQ==</Binary>
</Signal>