Skip to content

StreamPackage Endpoints โ€‹

Updated

An endpoint is the output configuration that exposes a channel's input as a playlist for viewers to pull. Keep the two apart: the input address is for publishing, while the endpoint URL is for playback.

Prerequisites โ€‹

Confirm the channel and input protocol, then decide on the playback format, access policy, and whether time shifting and DRM are needed. Start the basic HLS playback check without any additional features, and verify the features you need separately.

Creating in the Console โ€‹

  1. Open the Output Endpoint tab in the channel details.
  2. Select Create Output Endpoint.
  3. Specify Name and Type.
  4. Enter the Playback List Name. This corresponds to Manifest Name in the official documentation.
  5. Review the IP Restriction / AuthKey / time-shifting / DRM settings you need.
  6. Save with Confirm, then check the URL in the resulting list.

HLS Output endpoint creation screen

HLS Checking the playback address in the endpoint list

The URLs in the screenshots are redacted. Copy your own address from the actual console. The default playback list name main corresponds to main.m3u8 in HLS. If you changed it to index, you must request index.m3u8 instead.

Access Policy โ€‹

SettingWhat to verify
IP restrictionWhether the actual requester is a player or an origin-pull node of CDN
AuthKeyAuthentication based on the HTTP header X-TENCENT-PACKAGE
HTTPSA valid certificate applied to the playback domain
DRMSupported output formats and license integration requirements

AuthKey is used in the authentication header of origin requests. Configure the required credential passthrough in CDN and store the credential values securely.

API Query โ€‹

bash
tccli mdp DescribeStreamPackageChannel --region ap-seoul --Id YOUR_CHANNEL_ID

Compare the endpoint name, protocol, Manifest, and URL in the query result against the console. For the supported values per protocol and whether each field is required, check the schema of the API version you are using.

Time Shifting โ€‹

Once Time-shifted Viewing is enabled, you can construct playback requests for retained live segments. The requested range must fall within the range that is actually retained.

text
https://YOUR_HOST/YOUR_ENDPOINT/main.m3u8?timeshift=1&start=2026-09-18T00:00:00Z&end=2026-09-18T01:00:00Z

Per the official guide, the start time must fall within the Startover Windows, and the end time must be later than the start. A range returned for a specified start and end can span at most 24 hours.

Distinguishing from Ad Insertion โ€‹

Playback paths by viewing purpose

For SSAI, verify ad insertion after configuring the main content source, ADS, and sessions. Verify plain HLS playback first, then the ad integration.

Completion Checks and Deletion โ€‹

Verify the master playlist, the media playlist, the actual segments, and the video / audio in that order. Before deleting, check the CDN and player addresses in use. If you recreate a deleted endpoint, the URL may change.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages