Console Guide

StreamPackage to Become Paid Product

Updates and Announcements

Introduction

Billing Details

Overdue Payments and Service Suspension

Purchase Guide

Harvest Jobs

Server-Side Ad Insertion

Source Location

Channel

Program

Channel Linear Assembly

Implementing Live Streaming

Configuring Multi-DRM

Preparations

Configuration

Configuring SSAI AD Insertion

Overview

Create Content Source

 Configuring Linear Assembly Channel and Program

 Configuring Channel Advertising 

Start channel 

Create FAST（Free Ad-Supported Streaming TV）Channel

Practical Application

History

API Category

Request Structure

Common Params

Signature v3

Signature

Responses

Making API Requests

BindNewLVBDomainWithChannel

CreateStreamPackageChannel

DeleteStreamPackageChannelEndpoints

DeleteStreamPackageChannels

DescribeStreamPackageChannel

DescribeStreamPackageChannels

ModifyStreamPackageChannel

ModifyStreamPackageChannelInputAuthInfo

UnbindCdnDomainWithChannel

CreateStreamPackageChannelEndpoint

ModifyStreamPackageChannelEndpoint

Channel Management APIs

CreateStreamPackageSSAIChannel

DeleteStreamPackageSSAIChannel

DescribeStreamPackageSSAIChannel

DescribeStreamPackageSSAIChannels

ModifyStreamPackageSSAIChannel

SSAI APIs

DescribeStreamPackageLinearAssemblyChannelAlerts

DescribeStreamPackageSourceAlerts

DeleteStreamPackageLinearAssemblyPrograms

DeleteStreamPackageLinearAssemblyChannels

ModifyStreamPackageSourceLocation

CreateStreamPackageSourceLocation

DescribeStreamPackageSourceLocationAlerts

CreateStreamPackageLinearAssemblyProgram

CreateStreamPackageLinearAssemblyChannel

CreateStreamPackageSource

StartStreamPackageLinearAssemblyChannel

StopStreamPackageLinearAssemblyChannel

DeleteStreamPackageLinearAssemblyChannel

DeleteStreamPackageLinearAssemblyProgram

DeleteStreamPackageSource

DeleteStreamPackageSourceLocation

DescribeStreamPackageLinearAssemblyChannel

DescribeStreamPackageLinearAssemblyProgram

DescribeStreamPackageSource

DescribeStreamPackageSourceLocation

DescribeStreamPackageLinearAssemblyChannels

DescribeStreamPackageLinearAssemblyProgramSchedules

DescribeStreamPackageLinearAssemblyPrograms

DescribeStreamPackageSourceLocations

DescribeStreamPackageSources

ModifyStreamPackageLinearAssemblyChannel

ModifyStreamPackageLinearAssemblyProgram

ModifyStreamPackageSource

UnbindLinearAssemblyCDNDomainWithChannel

DescribeLinearAssemblyCDNDomainWithChannels

DescribeLinearAssemblyCDNDomainWithChannel

BindLinearAssemblyCDNDomainWithChannel

Channel linear assembly management APIs

CreateStreamPackageHarvestJob

DeleteStreamPackageHarvestJob

DeleteStreamPackageHarvestJobs

DescribeStreamPackageHarvestJob

DescribeStreamPackageHarvestJobs

HarvestJob Management APIs

Data Types

Error Codes

API Documentation

Data Processing and Security Agreement

Privacy Policy

StreamPackage Policy

StreamPackage

StreamPackage is a high-quality video packaging and origin platform. It offers professional, stable, secure, and easy-to-use video packaging and delivery services globally and helps you enhance origin resilience. You can use StreamPackage to securely and reliably distribute video streams at a large scale.

StreamPackage manages tasks at the channel level. It packages compressed and encoded audio and video tracks into certain formats for distribution.

The StreamPackage console provides a rich set of easy-to-use and flexible features. It manages tasks at the channel level and functions through four main sections: channel, input, endpoint, and CDN.

You have a domain for playing videos from CDNs (if you want to use Tencent Cloud’s live streaming CDN for content distribution).

https://console.tencentcloud.com/live

https://console.tencentcloud.com/mdp/channel

Currently, StreamPackage services are available in Bangkok (Thailand), Seoul (South Korea), Tokyo (Japan), Frankfurt (Germany), and Singapore. If you want to deploy your business in other regions, please 

https://intl.cloud.tencent.com/contact-sales

A channel holds basic information about inputs and outputs. You can configure a channel to receive live streams that use a specific protocol. You can also create endpoints to generate content to be distributed.

Enter a channel name and select an input protocol (HLS and DASH are supported).

 indicates the maximum duration of HLS TS segments or DASH M4S segments pushed to this channel. The default is 15 seconds.

 indicates the maximum total duration of the HLS M3U8 or DASH MPD playlist pushed to this channel. The default is 600 seconds.

If you are sending two streams, one primary stream and one backup stream, to the channel for failover, we recommend you set 

After the channel is created, you will be directed to the channel details page (you can also go to the details page by clicking the channel name or 

 on the right). This page displays the channel's name, ID (automatically generated), input protocol, and other settings. StreamPackage will generate two inputs of the specified protocol for the channel.

An input is the basic unit of the content StreamPackage receives. After a channel is created, StreamPackage will automatically generate two inputs as well as two input URLs for the channel. You can send streams to the URLs.

You can enable authentication for an input: Click 

 column.  StreamPackage will generate a username and a password for HTTP authentication. Click 

Once you rotate credentials, the existing credentials of the channel will become invalid.

You can create endpoints for a channel so that streams can be pulled from the channel.

Enter an endpoint name. The endpoint type defaults to the same as the channel's input protocol. Additionally, if your input protocol is HLS, you can also select CMAF-DASH or CMAF-HLS as the type. StreamPackage supports remuxing HLS into CMAF-DASH or CMAF-HLS.

If you want to modify the Manifest Name, please enter the name in “Manifest Name”, the default value is main.

HLS repackaging into CMAF (DASH format) does not currently support DRM inputs.

You can also enable IP allowlist/blocklist and AuthKey if necessary.

IP allowlist/blocklist: Allow only specific IP address ranges to push or disallow specific IP address ranges to push.

AuthKey: Perform authentication using the HTTP header field X-TENCENT-PACKAGE.

If you need the timeshift feature, you can enable the "Time-shifted Viewing" to activate it.

Startover Windows：Set how long StreamPackage will support time-shifted viewing for the content. Default value is 1 day, and 3days, 7 days, 15 days and 30 days are also supported. 

Once timeshift is enabled, live segments will be saved in the cloud, and you can watch them with timeshift by adding specific parameters to the Endpoint URL. The parameters are as follows:

timeshift=1, Indicates that you want to watch TimeShift stream.

start=xxx, indicating the start time of the timeshift. It supports either the ISO 8601 dates format or the POSIX (or Epoch) time format.

end=xxx, indicating the end time of the timeshift. It supports either the ISO 8601 dates format or the POSIX (or Epoch) time format.

If both start and end are specified, end must be greater than start, otherwise a 400 error will be returned.

The start time must be within the Startover Windows range, otherwise a 400 error will be returned.

Only a maximum of 24 hours of timeshift content can be returned. This means that the time difference between end and start cannot exceed 24 hours, otherwise a 400 error will be returned.

Request timeshift content from 2023-07-01T00:00:00Z to 2023-07-01T23:59:59Z:

http://domain/v1/path/subpath/playlist.m3u8?timeshift=1&start=2023-07-01T00:00:00Z&end=2023-07-01T23:59:59Z

http://domain/v1/path/subpath/playlist.m3u8?timeshift=1&start=1688169600&end=1688255999

Request live content starting from 2023-07-01T00:00:00Z until the end of the live stream:

http://domain/v1/path/subpath/playlist.m3u8?timeshift=1&start=2023-07-01T00:00:00Z

http://domain/v1/path/subpath/playlist.m3u8?timeshift=1&start=1688169600

CMAF type time-shifting does not currently support SCTE-35.

When the created Endpoint type is CMAF-HLS or CMAF-DASH, you can configure DRM.

DRM Platform: PlayReady/Widevine/FairPlay options available.

Resource ID: The ID passed to the DRM provider to identify this stream; the same ID needs to be filled in during playback, and it is recommended to be globally unique.

Key Server URL: HTTP URL of the server supporting the CPIX 2.3 protocol (obtain from your DRM provider).

Video Encryption Preset: Select the encryption method for the video.

Audio Encryption Preset: Select the audio encryption method.

Constant Initialization Vector: Enter the specified initialization vector.

Key Rotation Interval: If key rotation is required, enter the corresponding seconds here. If not filled in, the key will not be updated periodically by default.

 and the endpoint is created. You can modify or delete the endpoint. From the endpoint URL generated, you can pull streams and distribute them.

You can create a CDN distribution for a StreamPackage channel to distribute the streams in the channel via Tencent Cloud’s live streaming CDN. To achieve this, you need to activate CSS and 

grant CSS access to StreamPackage and StreamPackage access to CSS

Before we proceed, make sure you understand the following terms:

LVB CDN: StreamPackage allows you to quickly distribute streams in a channel via the LVB CDN.

CDN domain/CDN playback domain: A playback domain in the LVB CDN, which can be used to distribute live streams.

Before you configure a CDN distribution, make sure you have activated 

https://console.tencentcloud.com/live?from=product-banner-use-lvb

In the StreamPackage console, go to the details page of the channel for which you want to configure a CDN distribution, select the 

After the authorization, you will be able to configure a CSS playback domain for a StreamPackage channel.

. To distribute streams via the LVB CDN, you need to allow StreamPackage to access certain resources. This is achieved via a service role. Click 

 to grant StreamPackage the permission to use related APIs.

You will be directed back to the StreamPackage console. Click 

 to go to the CDN console and allow the LVB CDN to use StreamPackage. After the authorization, you will see that the authorization status for StreamPackage has become 

Return to the StreamPackage console and click 

tencent cloud