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 click Analytics & AI. Under Media Services, click 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. Click the name of the channel where you want to package the configuration.
    4. On the Distribution Channel details page, under Resources, click Packaging Configurations.
    5. Click Create Packaging Configuration.
    6. In the Create Packaging Configuration panel, enter a name for the packaging configuration and then provide the following information:
      • Format: Select HLS or DASH.
      • Segment size in seconds: Specify the segment size. 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) To apply tags to the packaging configuration, click Show advanced options.
      Tagging is a metadata system that lets you organize and track the resources in your tenancy. If you have permissions to create a resource, you also have permissions to add free-form tags to it. To apply a defined tag, you must have permissions to use the tag namespace. For general information about tagging, see Resource Tags and Tagging Overview.
    8. Click Create. The packaging configuration is created and listed in the Packaging Configurations section.
  • 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.