Oracle Cloud Infrastructure Documentation

Creating a Packaging Configuration

Create a packaging configuration for HTTP Live Streaming (HLS) packaging of video content in Media Streams.

    1. Open the navigation menu  and select Analytics & AI. Under Media Services, select Media Streams.
    2. On the Distribution channels list page, select the compartment that contains the distribution channel where you want to package the configuration.
    3. Select the name of the channel where you want to package the configuration.
    4. On the details page, select Packaging configurations.
    5. Select Create packaging configuration.
    6. In the Create packaging configuration panel, enter a name for the packaging configuration and then provide the following information:
      • Packaging format: Select HLS or DASH.
      • Segment size: Specify the segment size in seconds. This setting enables you to override the size of the original asset with the larger segment size. For example, if the segment size of the ingested asset is four seconds and the requested segment size of the packaging configuration is two seconds, then the effective segment size is four seconds. Similarly, if the segment size of the ingested asset is four seconds and the requested segment size of the packaging configuration is eight seconds, then the effective segment size is eight seconds.
      • Encryption algorithm: When encryption is enabled on a packaging configuration, the video segments are encrypted using a data key that is dynamically generated for each playlist. This data key is envelope-encrypted with either an Oracle managed master key or a user-provided master key stored in the OCI Vault service vault of the user. For HLS playlists, the player retrieves the data key by using the EXT-X-KEY tag. The Initialization Vector (IV) used for decrypting a particular segment is the segment number specified in RFC 8216. The available encryption algorithm is AES128.
      • KMS KEY Id: Specify the KMS key ID. This is the OCI Vault service master encryption key ID. For more details, see Viewing Vault Key Details.
    7. (Optional) In the Tags section, add one or more tags to the packaging configuration.
      If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
    8. Select Save.
      The packaging configuration is created and listed on the Packaging configurations tab.

  • To create a packaging configuration, use the following commands: create-stream-packaging-config-encryption-aes128 

    oci media-services stream-packaging-config create-stream-packaging-config-encryption-aes128 [OPTIONS]
    Or, create-stream-packaging-config-encryption-none 
    oci media-services stream-packaging-config create-stream-packaging-config-encryption-none [OPTIONS]

    Required parameters for the create-stream-packaging-config-encryption-aes128 command are:

    • --display-name [text]
    • --distribution-channel-id [text]
    • --segment-time-in-seconds [integer]
    • --stream-packaging-format [text]
    • --encryption-kms-key-id [text]

    Required parameters for the create-stream-packaging-config-encryption-none command are:

    • --display-name [text]
    • --distribution-channel-id [text]
    • --segment-time-in-seconds [integer]
    • --stream-packaging-format [text]

    To get all the commands for stream-distribution-channel:

    oci media-services stream-packaging-config -h

    To get help for the create-stream-packaging-config-encryption-aes128 command:

    oci media-services stream-packaging-config create-stream-packaging-config-encryption-aes128 -h

    To get help for the create-stream-packaging-config-encryption-none command:

    oci media-services stream-packaging-config create-stream-packaging-config-encryption-none -h

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • To create a packaging configuration, use the CreateStreamPackagingConfig operation.