Overview

Last updated: 2020-09-24 10:29:42

    VOD supports multiple methods to play back uploaded and transcoded videos, and video playback mainly involves the following three scenarios:

    Scenario Description Recommended Playback Method
    Short video playback Playback of videos of less than 5 minutes in length Basic player
    Long video playback Playback of videos produced by professional organizations and published on video websites Superplayer
    Encrypted video playback Playback of long videos requiring encryption for copyright protection Superplayer

    This document describes the three scenarios' characteristics and recommended playback methods.

    Short Video Playback

    Short videos generally refer to videos of less than 5 minutes in length, mainly including:

    • Videos shared on UGSV social medias (such as WeSee, Kuaishou, and TikTok).
    • Product promotion videos shared on ecommerce platforms (such as JD.com and Pinduoduo).
    • Videos shared on WeChat Official Account and we media.

    Playback architecture

    For short video playback scenarios, VOD provides the basic player SDK, which uses the URL as a parameter to play back the selected video on demand.

    The overall architecture of playback with the basic player SDK is as follows:

    1. Upload from server: the business backend uploads a video to VOD through the console, server API, or other means.
    2. Trigger video processing: when the video is uploaded, transcoding can be specified. After the video is uploaded, the transcoding process begins.
    3. Transcode and write to storage: after the video is transcoded, the output video content is written to the VOD storage.
    4. Download the content: the basic player downloads the content from VOD CDN at the download address.
    5. Play back the video: the basic player plays back the video.

    Integration with basic player

    For the features supported by the basic player SDK, please see Feature list. For the integration method, please see Download and use.

    Long Video Playback

    Long videos generally refer to videos produced by professional organizations and published on video websites, mainly including:

    • Exclusive TV series and variety shows published on video social media (such as Tencent Video, Youku, and iQIYI).
    • Course videos published on online education websites (such as Tencent Class and Penguin Tutoring).
    • TV programs replayed on online TV platforms (such as CNTV and Mongo TV).

    Playback architecture

    For long video playback scenarios, VOD provides the superplayer SDK, which uses the FileId as a parameter to play back the selected video on demand.

    The overall architecture of playback with the superplayer SDK is as follows:

    1. Upload from server: the business backend uploads a video to VOD through the console, server API, or other means.
    2. Trigger video processing: when the video is uploaded, adaptive bitrate streaming is specified. After the video is uploaded, video processing begins.
    3. Transcode to adaptive bitstream and write to storage: after the video is transcoded to adaptive bitstream, the output video content is written to the VOD storage.
    4. Update the media asset: the output video information is written into the media asset management module.
    5. Request the download address: the superplayer gets the download address of the video from VOD's playback service after the video's FileId is specified.
    6. Download the content: the superplayer downloads the content from VOD CDN at the download address.
    7. Play back the video: the superplayer plays back the output adaptive bitstream.

    If key hotlink protection is enabled for the video to be played back, the superplayer signature needs to be specified during the playback. In this case, the architecture is as follows:

    1. The "signature distribution" service needs to be built on the business backend, and a signature is generated according to the player signature calculation rule.
    2. The superplayer gets the player signature before playing back the video (as shown in step 5 below).
    3. When the superplayer requests the download address (as shown in step 6 below), the playback service will return the download address only after verifying that the signature is valid.

    Integration with superplayer

    For the features supported by the superplayer SDK, please see Feature list. For the integration method, please see Download and use.
    To help you quickly integrate the superplayer of VOD, we provide a superplayer integration guide to describe the integration steps by way of demos.

    Encrypted Video Playback

    Video encryption is a specific scenario of long video playback scenarios, where copyrighted videos such as exclusive TV series and online courses are encrypted to avoid unauthorized download and distribution.
    For more information on how video encryption works and the integration methods, please see Video Encryption Overview and Video Encryption Integration Guide.

    Player SDK

    Download and use

    Player Type SDK Download Address User Guide
    Superplayer

    Feature list

    Basic player

    Feature Description Mobile (Android and iOS) Web
    Wide variety of formats A wide variety of formats such as RTMP, FLV, HLS, and MP4 are supported
    Instant streaming of the first frame The first frame of videos can be streamed instantly
    Seamless switch of resolution Different resolutions can be switched between with no lags ×
    Quick seeking The specified position can be quickly located to play back the video image there
    H.265 hardware decoding Playback based on hardware decoding is supported for H.265 videos ×
    Automatic switch between software and hardware decoding If the device does not support hardware decoding, software decoding will be automatically used ×
    Custom HTTP header The HTTP headers in video resource requests are customizable ×
    Adaptive bitrate If an HLS adaptive bitstream is played back, the bitrate is adaptive to the network bandwidth
    Small window playback Videos can be played back in a small window ×
    Speed-adjustable playback Videos can be played back at different speeds, and the audio tone will stay the same even if the speed changes ×
    Streaming When a video is played back, its rest content is downloaded and buffered at the same time
    On-screen commenting Comments can be displayed above video ×
    Mute Audio can be muted during video playback
    Video screencapturing The video image can be captured as screenshots ×
    Video rotation The video image can be rotated at the specified angle ×
    Video mirroring The video image can be mirrored horizontally or vertically ×
    Screen filling/fitting Different display modes can be selected for the video image to match the screen size ×
    Custom streaming start time The time when streaming starts is customizable
    Cover configuration The cover of the video to be played back can be set
    Player dimensions configuration The player's width and height can be set
    Support for HTTPS HTTPS video resources can be played back
    Playback through URL Online videos can be played back at URLs
    Live streaming recording Recorded live streaming videos can be played back
    Custom video rendering After being decoded, videos can be rendered onto the screen ×
    Seamless loop playback A single video can be looped
    Interactive floating window Videos can be played back in a floating window ×
    Automatic video rotation Videos can be rotated according to the internal rotate parameter ×
    Custom progress callback interval The progress callback interval is customizable ×

    Superplayer

    Feature Description Mobile (Android and iOS) Web
    Instant streaming of the first frame The first frame of videos can be streamed instantly
    Seamless switch of resolution Different resolutions can be switched between with no lags
    Quick seeking The specified position can be quickly located to play back the video image there
    H.265 hardware decoding Playback based on hardware decoding is supported for H.265 videos ×
    Automatic switch between software and hardware decoding If the device does not support hardware decoding, software decoding will be automatically used ×
    Hotlink protection Videos with hotlink protection enabled are supported
    Preview Videos with preview enabled are supported
    Playback of encrypted video Encrypted videos can be played back on demand
    Custom HTTP header The HTTP headers in video resource requests are customizable ×
    Adaptive bitrate If an HLS adaptive bitstream is played back, the bitrate is adaptive to the network bandwidth
    Custom substream specification name During the playback of a custom bitstream, the specification name of each substream is customizable
    Small window playback Videos can be played back in a small window ×
    Speed-adjustable playback Videos can be played back at different speeds, and the audio tone will stay the same even if the speed changes ×
    Streaming When a video is played back, its rest content is downloaded and buffered at the same time
    On-screen commenting Comments can be displayed above video ×
    Mute Audio can be muted during video playback
    Video screencapturing The video image can be captured as screenshots ×
    Video rotation The video image can be rotated at the specified angle ×
    Video mirroring The video image can be mirrored horizontally or vertically
    Screen filling/fitting Different display modes can be selected for the video image to match the screen size ×
    Custom streaming start time The time when streaming starts is customizable
    Gesture The brightness, volume level, and progress can be adjusted through gestures ×
    Cover configuration The cover of the video to be played back can be set
    Thumbnail preview Thumbnails can be displayed on the progress bar for preview
    Progress bar timestamp Timestamp information can be added to the progress bar
    Playback list Videos in the playback list can be played back in sequence ×
    Player dimensions configuration The player's width and height can be set
    File download Online videos can be downloaded ×
    Support for HTTPS HTTPS video resources can be played back
    Playback through FileId Videos can be played back through their FileId values in VOD
    Custom video rendering After being decoded, videos can be rendered onto the screen ×
    Seamless loop playback A single video can be looped
    Interactive floating window Videos can be played back in a floating window ×
    Automatic video rotation Videos can be rotated according to the internal rotate parameter ×
    Custom progress callback interval The progress callback interval is customizable ×

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help