:Get started with ApsaraVideo VOD

Upload using an SDK (Recommended)

The backend calls an SDK to obtain an upload credential. The client (browser or app) then uploads directly to ApsaraVideo VOD.

# Python example: The backend service obtains an upload credential and address.
from aliyunsdkvod.request.v20170321 import CreateUploadVideoRequest
from aliyunsdkcore.client import AcsClient
import json

# 1. Initialize the client.
# Replace the placeholders with your AccessKey ID, AccessKey secret, and region ID.
client = AcsClient('your-access-key-id', 'your-access-key-secret', 'cn-shanghai')

# 2. Create an API request and set the parameters.
request = CreateUploadVideoRequest.CreateUploadVideoRequest()
request.set_Title('My Test Video')
request.set_FileName('video_test.mp4')
# request.set_TemplateGroupId('your-transcode-template-group-id') # Optional. Specify a transcoding template.

# 3. Send the request and obtain the response.
response = client.do_action_with_exception(request)
response_data = json.loads(response)

# 4. Return UploadAddress and UploadAuth to the client.
upload_address = response_data['UploadAddress']
upload_auth = response_data['UploadAuth']
video_id = response_data['VideoId']

# After the client obtains the credential, use the upload SDK to upload the file.

Upload using the console

Go to the Audio/Video page in the ApsaraVideo VOD console. Click Upload, then click Add Media. Select a local file or drag the file to the upload area.

Backend: obtain a playback credential

The backend calls an API to generate a time-limited playback credential (PlayAuth) for each request.

# Python example: Obtain a playback credential.
from aliyunsdkvod.request.v20170321 import GetVideoPlayAuthRequest

# The client has been initialized in the upload step.
request = GetVideoPlayAuthRequest.GetVideoPlayAuthRequest()
request.set_VideoId('your-video-id') # Replace the placeholder with the actual VideoId.
request.set_AuthInfoTimeout(3000)  # The validity period of the credential in seconds. In this example, the period is 50 minutes.

response = client.do_action_with_exception(request)
play_auth = json.loads(response)['PlayAuth']

# Return the obtained play_auth and video_id to the frontend.

Frontend: integrate the player

The frontend player uses the vid and playAuth obtained from the backend to initialize playback.

Web

<!-- Web player example -->
<div id="player-container"></div>
<script src="https://g.alicdn.com/de/prismplayer/2.15.2/aliplayer-min.js"></script>

<script>
  var player = new Aliplayer({
    id: 'player-container',
    width: '100%',
    height: '500px',
    vid: 'your-video-id',      // Obtained from the backend
    playauth: 'your-play-auth', // Obtained from the backend
    cover: 'https://your-domain.com/cover.jpg' // Thumbnail URL
  }, function (player) {
    console.log('The player is created.');
  });
</script>

Android

// 1. Create a player.
AliPlayer player = AliPlayerFactory.createAliPlayer(context);

// 2. Configure the playback source.
VidAuth vidAuth = new VidAuth();
vidAuth.setVid("your-video-id");
vidAuth.setPlayAuth("your-play-auth");
vidAuth.setRegion("cn-shanghai"); // Set the region.

// 3. Prepare for playback.
player.setDataSource(vidAuth);
player.prepare();

iOS

// 1. Create a player.
let player = AliPlayer()

// 2. Configure the playback source.
let vidAuth = AVPVidAuthSource()
vidAuth.vid = "your-video-id"
vidAuth.playAuth = "your-play-auth"
vidAuth.region = "cn-shanghai" // Set the region.

// 3. Prepare for playback.
player.setSource(vidAuth)
player.prepare()