ApsaraVideo VOD:高度な機能

ビデオ画像の表示機能を無効にして、オーディオのみの再生を有効にすることができます。 prepareメソッドを呼び出す前に、PlayerConfigクラスを設定します。

AVPConfig *config = mPlayerPtr->getConfig();
config->mDisableVideo = true;
mPlayerPtr->setConfig(config);

ApsaraVideo Player SDK for Windowsは、HTTP Live streaming (HLS) ビデオストリームおよびDynamic adaptive Streaming over HTTP (DASH) ビデオストリームのアダプティブビットレートストリーミングをサポートしています。 prepareメソッドが呼び出された後、getMediaInfoを呼び出して、TrackInfoで示されるストリーム情報を取得します。 サンプルコード:

AVPMediaInfo info = mPlayerPtr->getMediaInfo();
for (int i = 0; i < info.trackCount; i++) {
     AVPTrackInfo *track = info.tracks[i];
}

再生中に、selectTrackを呼び出して、必要なビットレートに切り替えることができます。 メソッドでSELECT_AVPTRACK_TYPE_VIDEO_AUTOを指定すると、適応ビットレートストリーミングが有効になります。 サンプルコード:

// Switch the bitrate.
mPlayerPtr->selectTrack(trackIndex);
// Switch to the adaptive bitrate.
mPlayerPtr->selectTrack(SELECT_AVPTRACK_TYPE_VIDEO_AUTO);

onTrackChangedメソッドによって呼び出されるコールバックは、切り替え結果を返します。 サンプルコード:

void AlivcLivePlayerMainDlg::onTrackChanged(AliPlayer *player, AVPTrackInfo *info)
{
    if (info->trackType == AVPTRACK_TYPE_VIDEO) {
        // video changed
    }
    // etc
}

snapShot操作を呼び出して、ビデオスナップショットをキャプチャできます。 プレイヤーはキャプチャしたスナップショットをARGB32形式で保存します。 onSnapshotImageBufferコールバックが呼び出された後、キャプチャされたスナップショットに関する情報を取得できます。 サンプルコード:

// Capture a snapshot of the current video image.
mPlayerPtr->snapshot();
// Configure the callback for snapshot capture.
void AlivcLivePlayerMainDlg::onSnapshotImageBuffer(AliPlayer *player, int width, int height, unsigned char *pARGBBuffer)
{
    QString savePath = "save path";
    QImage snapshot(pARGBBuffer, width, height, QImage::Format_ARGB32);
    snapshot.save(savePath);
}

プレビュー機能を有効にした後、VidPlayerConfigGeneratorでsetPreviewTime操作を呼び出して、プレビュー期間を指定できます。 プレビュー期間を指定すると、ApsaraVideo Player SDK for Windowsでは、ビデオ全体ではなく、指定した期間のビデオをプレビューできます。 次のサンプルコードに例を示します。 この例では、VidStsが使用されます。

VidPlayerConfigGenerator playConfigGen;
playConfigGen.setPreviewTime(10);
AVPVidStsSource vidSource;
vidSource.initWithVid(Video ID,
                        "accessKeyId",
                        "accessKeySecret",
                        "Security token",
                        "Access region ID",
                        playConfigGen.generatePlayerConfig());
mPlayerPtr->setSource(vidSource);

ApsaraVideo Player SDK for Windowsには、リクエストリファラーを設定するためのAVPConfigクラスが用意されています。 ApsaraVideo VODコンソールで設定されたリファラーホワイトリストまたはブラックリストと一緒にリファラーを使用して、アクセス制御を実装できます。 サンプルコード:

// Obtain the configuration information.
AVPConfig *pConfig = mPlayerPtr->getConfig();
// Set the referer.
pConfig->referer = referer;
....// Configure other settings.
// Configure the settings for the player.
mPlayerPtr->setConfig(pConfig);

ApsaraVideo Player SDK for Windowsには、リクエストユーザーエージェントを指定するためのAVPConfigクラスが用意されています。 ユーザーエージェントを指定すると、プレイヤーはリクエストにユーザーエージェント情報を含めます。 サンプルコード:

// Obtain the configuration information.
AVPConfig *pConfig = mPlayerPtr->getConfig();
// Specify the user agent.
pConfig->userAgent = userAgent;
....// Configure other settings.
// Configure the settings for the player.
mPlayerPtr->setConfig(pConfig);

ApsaraVideo Player SDK for Windowsには、ネットワークタイムアウト期間と再試行回数を設定するためのAVPConfigクラスが用意されています。 サンプルコード:

// Obtain the configuration information.
AVPConfig *pConfig = mPlayerPtr->getConfig();
// Set the network timeout period. Unit: milliseconds.
pConfig->networkTimeout = 5000;
// Specify the maximum number of retries upon a network timeout. The retry interval equals the timeout period specified by the NetworkTimeout parameter. The networkRetryCount parameter specifies the maximum number of retries. A value of 0 indicates zero retry. The application determines the maximum number of retries. Default value: 2.
pConfig->networkRetryCount = 2;
....// Configure other settings.
// Configure the settings for the player.
mPlayerPtr->setConfig(pConfig);

バッファ制御は、プレーヤーにとって重要です。 適切な設定を使用することで、スタートアップの読み込み時間を短縮し、再生のスムーズさを向上できます。 ApsaraVideo Player SDK for Windowsには、バッファ設定とレイテンシ設定を構成できるAVPConfigクラスが用意されています。 サンプルコード:

// Obtain the configuration information.
AVPConfig *pConfig = mPlayerPtr->getConfig();
// Set the maximum latency. This parameter is valid only for live streaming. If the latency exceeds the maximum limit, ApsaraVideo Player SDK synchronizes frames to ensure that the latency does not exceed the limit. 
pConfig->maxDelayTime = 5000;
// Set the maximum buffer duration. Unit: milliseconds. This parameter specifies the maximum buffer duration for the player to load data at a time. 
pConfig->maxBufferDuration = 50000;
// Set the peak buffer duration. Unit: milliseconds. This parameter specifies the peak buffer duration. After the peak buffer duration elapses, the player stops loading data when the network conditions are poor. 
pConfig->highBufferDuration = 3000;
// Set the startup buffer duration Unit: milliseconds. A smaller value indicates a shorter startup buffer duration. In this case, the player starts to load data sooner after the playback starts. 
pConfig->startBufferDuration = 500;
// Configure other settings.
// Configure the settings for the player.
mPlayerPtr->setConfig(pConfig);

ApsaraVideo Player SDKは、プレーヤーのHTTPヘッダーを設定するためのAVPConfigクラスを提供します。 サンプルコード:

// Obtain the configuration information.
AVPConfig *pConfig = mPlayerPtr->getConfig();
// Configure the header.
pConfig->headerCount = 1;
pConfig->httpHeaders = new char *[pConfig->headerCount];
// Configure a host when you use Alibaba Cloud HTTPDNS. 
pConfig->httpHeaders[0] = strdup("Host:example.com");
....// Configure other settings.
// Configure the settings for the player.
mPlayerPtr->setConfig(pConfig);

ApsaraVideo Player SDK for Windowsでは、再生中にビデオをキャッシュできます。 これにより、ループ再生中のトラフィックが節約されます。 ローカルキャッシュ機能を設定するには、prepareメソッドを呼び出す前にAVPCacheConfigを呼び出します。 サンプルコード:

AVPCacheConfig mCacheConfig;
// Enable the local caching feature.
mCacheConfig.enable = true;
// Specify the maximum duration of a single cached file. Files whose duration exceeds the upper limit are not cached.
mCacheConfig.maxDuration = 100;
// Specify the maximum size of the cache directory. If the total size of cached files in the cache directory exceeds the upper limit, the earliest cached files are overwritten.
mCacheConfig.maxSizeMB = 200;
// Set the cache directory to the directory required by your application.
mCacheConfig.path = strdup("please use your cache path here");
// Configure the cache settings for the player.
mPlayerPtr->setCacheConfig(&mCacheConfig);

キャッシュファイルを使用するには、setCacheConfigを呼び出す必要があります。 キャッシュファイルは、次のシナリオで使用されます。

• ループ再生機能を有効にすると、プレーヤーは、再生が完了するたびに、キャッシュされたビデオファイルを使用してビデオを自動的に再生します。

• ビデオをキャッシュし、ビデオを再生するプレーヤーを作成すると、新しいプレーヤーはキャッシュされたビデオファイルを使用してビデオを再生します。

  重要

  プレーヤーは、オンライン要求からのビデオIDなどの情報を使用して、ビデオIDベースの再生のためにキャッシュされたファイルを見つけます。

次の情報は、再生およびキャッシュ機能の制限について説明しています。

• ビデオの再生にUrlSourceを使用し、再生URLがHLS形式の場合、プレーヤーは再生中にビデオをキャッシュしません。 再生URLが他の形式の場合、プレーヤーは設定に基づいて再生中にビデオをキャッシュします。

• 再生にVidAuthまたはVidStsを使用する場合、プレーヤーは設定に基づいて再生中にビデオをキャッシュします。

• ビデオは、プレーヤーがすべてのビデオデータを読み取った後にキャッシュされます。 プレーヤーがすべてのビデオデータを読み取る前に、stopメソッドが呼び出されるか、onErrorコールバックが呼び出されると、キャッシュは失敗します。

• バッファ内シークはキャッシュ結果に影響しません。 バッファ外の位置へのシークは、キャッシング失敗を引き起こす可能性があります。

• セキュリティファイルがアプリケーション情報と一致しない場合、ビデオキャッシュは失敗します。

• onPlayerEventコールバックからキャッシュ結果を確認できます。 EVENT_PLAYER_CACHE_SUCCESSはビデオがキャッシュされていることを示し、EVENT_PLAYER_CACHE_ERRORはビデオがキャッシュされていないことを示します。

ApsaraVideo Player SDK for Windowsでは、ローカルデバイスにビデオをダウンロードして、ApsaraVideo Playerでオフライン再生できます。 通常のダウンロードモードと安全なダウンロードモードがサポートされています。

• 通常のダウンロード

  通常のダウンロードモードでダウンロードされたビデオは、Alibaba Cloudによって暗号化されず、サードパーティのプレーヤーで再生できます。

• 安全なダウンロード

  セキュアダウンロードモードでダウンロードされた動画は、Alibaba Cloudによって暗号化されます。 これらのビデオを再生するには、ApsaraVideo Playerのみを使用できます。