This document describes how to manage audios/videos in the VOD console, including editing basic audio/video information, publishing audios/videos, previewing audios/videos in Player, and generating web player code.
More Features
1. Log in to the VOD console and select Application Management on the left sidebar.
2. Select the target application.
3. Go to Media Assets > Video Management > Uploaded.
4. Click More to change the status or storage class of audio/video files or retrieve archived files.
Changing audio/video status
You can control access to a media file by changing its status.
Playback Prohibited: After the playback of an audio/video is prohibited, error 403 will be returned when resources of the selected asset (including the source file, transcoding result, and screenshots) are requested. You can still play the file in the VOD console.
Unblocked: Click this to unblock an audio/video file and allow users to access the file normally.
Note:
It takes about 5-10 minutes for the playback prohibiting/unblocking action to fully take effect.
Changing the storage class
You can change the storage class of a media file on this page. Currently, the following storage classes are supported:
Storage Class
STANDARD
STANDARD_IA
ARCHIVE
DEEP_ARCHIVE
Default in VOD
Yes
No
No
No
Storage costs
High
Medium
Low
Very low
Access performance
High
Low
Not supported
Not supported
Data retrieval fees
No
No
Yes
Yes
Supported regions
All
All
All
Beijing, Shanghai, and Chongqing
Minimum billable duration
None
30 days
90 days
180 days
Notes:
1. For files uploaded to VOD (whether using an API, from the SDK, or from the console), the default storage class is STANDARD.
3. Access performance refers to metrics such as time to first frame (TTFF) and stutter rate. We recommend you do not change the storage class of files that are frequently accessed. ARCHIVE and DEEP ARCHIVE files cannot be directly accessed (played or processed). You need to retrieve them first.
4. You can retrieve files from ARCHIVE or DEEP ARCHIVE files to STANDARD. The costs vary depending on the original storage class and retrieval mode.
5. DEEP ARCHIVE is currently available only in Beijing, Shanghai, and Chongqing.
6. There are minimum storage durations for STANDARD_IA, ARCHIVE, and DEEP ARCHIVE files. Storage fees for the minimum storage duration will be charged even if a file is stored for shorter than the period.
Note:
Minimum storage duration for STANDARD_IA files is 30 days. Storage fees for 30 days are charged even if the file is stored for a shorter period.
Minimum storage duration for ARCHIVE files is 90 days. Storage fees for 90 days are charged even if the file is stored for a shorter period.
Minimum storage duration for DEEP ARCHIVE files is 180 days. Storage fees for 180 days are charged even if the file is stored for a shorter period.
If a file is deleted before the minimum storage period elapses, the storage fee will be billed the following day for daily billed users and the following month for monthly billed users.
Use limits:
To move a file from ARCHIVE or DEEP ARCHIVE to another storage class, use the data retrieval feature.
Note:
You will fail to move a file from ARCHIVE or DEEP ARCHIVE to another storage class using the Change Storage Class feature.
Data Retrieval
You can use the data retrieval feature to move files from ARCHIVE or DEEP ARCHIVE to STANDARD. Multiple retrieval modes are supported, which differ in speed and cost. For details about data retrieval fees, see Data Retrieval.
Retrieval Mode
From ARCHIVE
From DEEP ARCHIVE
Expedited
5 minutes
Not supported
Standard
5 hours
24 hours
Bulk
12 hours
48 hours
Note:
A media asset (FileId) may be stored as multiple files, including the original file, transcoding results, and screenshots. The time it takes to retrieve these files may vary. VOD does not keep track of the retrieval progress of each file. Instead, it estimates the time it may take for all the files to be retrieved and denies access to the asset before the time elapses (even if all the files have already been retrieved).
Because a media asset may not be marked as retrieved even when it has actually been retrieved, the actual accessible period of the asset may be shorter than expected. Given this, we recommend you set the validity period of assets retrieved from DEEP_ARCHIVE one day longer than you actually need.
Editing Basic Information
1. Log in to the VOD console and select Application Management on the left sidebar.
2. Select the target application.
3. Go to Media Assets > Video Management > Uploaded.
4. Find the target video and click Manage. The Basic Info page shows a media file’s basic information, standard transcoding list, and adaptive bitrate streaming list.
Basic Info
Field
Description
Thumbnail
You can click the edit icon next to the thumbnail image to select an existing image in “Image Management” or upload a local image to use as the thumbnail.
Only JPG, PNG, and static GIF images are supported.
The image can be up to 1 MB in size and 1920 x 1080 in dimensions.
The filename cannot contain Chinese characters.
Name
You can rename a media file.
The name can contain up to 20 characters. Double quotation marks ("), single quotation marks ('), less-than signs (<), and greater-than signs (>) are not supported.
Category
You can modify the category of a media file.
Click the edit icon, select a category, and click **Confirm**.
Label
You can add labels to a media file.
Each label can be up to 16 characters long and can contain letters and numbers. Press Enter to add multiple labels.
Description
You can add a brief description to a media file.
The description can be up to 128 characters long.
Storage Type
You can modify the storage class of a media file.
Click Storage Type to move a file from STANDARD to STANDARD_IA or the other way around.
Standard Transcoding List: The source file and transcoding outputs.
You can copy the URL of a file or preview the file.
You can also delete a transcoding output file or generate a QR code for sharing.
Adaptive Bitrate Streaming List
You can copy the URL of a media file, preview the file, and view its details.
Screenshot Information
1. Log in to the VOD console and select Application Management on the left sidebar.
2. Select the target application.
3. Go to Media Assets > Video Management > Uploaded.
4. Find the target media file and click Manage to enter the Basic Info page.
5. Select the Screenshot Info tab. This page shows screenshots of the source video as well as processed videos, including animated images, image sprites, sampled screenshots, and time point screenshots.
Note:
Only the latest 100 entries are displayed. To get the information of all screenshots, click the download icon in the top-right corner.
Publishing Video
1. Log in to the VOD console and select Application Management on the left sidebar.
2. Select the target application.
3. Go to Media Assets > Video Management > Uploaded.
4. Find the target media file and click Manage to enter the Basic Info page.
5. Click Publish Video to enter the video publishing page, which displays the source and output video files.
Player Preview
After transcoding a video to an adaptive bitstream, you can preview it in the player. VOD supports preview in both the web player and client player.
Parameter Info
Playback Configuration: Displays all the configurations of the player. It comes with two configurations: default and basicDrmPreset. To configure your own parameter, you must first enable key hotlink protection for the primary distribution domain name via the Operation tab.
Configuration items
Configuration Item: Shows the configuration items for the selected player configuration.
If there is an adaptive bitrate stream and image sprite thumbnails for the media asset (file ID), you can preview it using a web player or client player.
If there isn’t an adaptive bitrate stream or image sprite thumbnails for the media asset (file ID), you will see the following messages:
Playback control
For a player configuration for which key hotlink protection is enabled, you can set parameters including playback URL expiration time, preview duration, and max playback IPs.
Playback URL expiration time: The expiration time of the playback URL.
Preview duration: The preview duration of a video, which must be longer than 30 seconds. If it is left empty, there will be no limit on playback duration.
Max playback IPs: The maximum number of IP addresses allowed to play the file.
Video preview
Web player
You can click a video to preview it on the web player. You can also copy the code and embed it into a webpage.
Client player
1. Download the Video Cloud Toolkit App.
2. Use the app to scan the QR code or enter the appID and fileID manually to preview the video on a client player.
Web Player Code Generation
1. Log in to the VOD console and select Application Management on the left sidebar.
2. Select the target application.
3. Go to Media Assets > Video Management > Uploaded.
4. Find the target media file and click Manage to enter the Basic Info page.
5. Select the Web Player Code Generation tab to manage your player information and web player code.
Click Modify in the Parameter Settings area. In the window that pops up, select a player from the drop-down list (for information on player configuration, see Web Player Management), and click Confirm.
In the Web Player Code area, choose a video resolution from the Video Dimension drop-down list, enable or disable auto playback, and select a code type (HTML or IFRAME).
6. Click Copy Code to copy the generated web player code.
