:高度な機能

音声のみの再生を有効にするには、ビデオ再生を無効にします。`prepare` メソッドを呼び出す前に `PlayerConfig` を設定する必要があります。

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

Windows 版 ApsaraVideo Player SDK は、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 に設定すると、アダプティブビットレートストリーミングが有効になります。サンプルコード：

// ビットレートを切り替えます。
mPlayerPtr->selectTrack(trackIndex);
// アダプティブビットレートに切り替えます。
mPlayerPtr->selectTrack(SELECT_AVPTRACK_TYPE_VIDEO_AUTO);

切り替えの結果は、onTrackChanged リスナーのコールバックで返されます。サンプルコード：

void AlivcLivePlayerMainDlg::onTrackChanged(AliPlayer *player, AVPTrackInfo *info)
{
    if (info->trackType == AVPTRACK_TYPE_VIDEO) {
        // ビデオが変更されました
    }
    // etc
}

ApsaraVideo Player SDK for Windows の snapShot メソッドを呼び出して、現在のビデオのスナップショットをキャプチャできます。スナップショットは、onSnapshotImageBuffer コールバックを通じて ARGB32 形式で返されます。サンプルコード：

// 現在のビデオフレームのスナップショットをキャプチャします。
mPlayerPtr->snapshot();
// スナップショットキャプチャのコールバック。
void AlivcLivePlayerMainDlg::onSnapshotImageBuffer(AliPlayer *player, int width, int height, unsigned char *pARGBBuffer)
{
    QString savePath = "保存パス";
    QImage snapshot(pARGBBuffer, width, height, QImage::Format_ARGB32);
    snapshot.save(savePath);
}

プレビュー機能を設定した後、VidPlayerConfigGenerator インターフェイスの setPreviewTime メソッドを呼び出して、プレーヤーのプレビュー時間を設定します。プレビュー時間を設定して SDK を使用してビデオを再生すると、サーバーは完全なビデオコンテンツの代わりにプレビュー期間のコンテンツのみを返します。次のサンプルコードは、VidSts を使用した再生の例です：

VidPlayerConfigGenerator playConfigGen;
playConfigGen.setPreviewTime(10);
AVPVidStsSource vidSource;
vidSource.initWithVid("ビデオ ID",
                        "アクセスキー ID",
                        "アクセスキーシークレット",
                        "セキュリティトークン",
                        "リージョン",
                        playConfigGen.generatePlayerConfig());
mPlayerPtr->setSource(vidSource);

ApsaraVideo Player SDK for Windows は、Referer の設定をサポートしています。コンソールで Referer をブラックリストおよびホワイトリストと併用して、アクセス権限を制御できます。リクエストの Referer を設定するには、AVPConfig インターフェイスを使用します。サンプルコード：

// 設定を取得します。
AVPConfig *pConfig = mPlayerPtr->getConfig();
// Referer を設定します。
pConfig->referer = referer;
....// その他の設定。
// プレーヤーに設定を適用します。
mPlayerPtr->setConfig(pConfig);

ApsaraVideo Player SDK for Windows は、リクエストの User-Agent (UA) を設定するための AVPConfig を提供します。UA を設定すると、プレーヤーはリクエストに UA 情報を含めます。サンプルコード：

// 設定を取得します。
AVPConfig *pConfig = mPlayerPtr->getConfig();
// User-Agent を設定します。
pConfig->userAgent = userAgent;
....// その他の設定。
// プレーヤーに設定を適用します。
mPlayerPtr->setConfig(pConfig);

ApsaraVideo Player SDK for Windows は、ネットワークタイムアウト期間と再試行回数の設定をサポートしています。これらの設定を行うには、AVPConfig インターフェイスを使用します。サンプルコード：

// 設定を取得します。
AVPConfig *pConfig = mPlayerPtr->getConfig();
// ネットワークタイムアウト期間をミリ秒単位で設定します。
pConfig->networkTimeout = 5000;
// タイムアウト時の再試行回数を設定します。再試行間隔は networkTimeout の値です。networkRetryCount を 0 に設定した場合、再試行は行われません。再試行ポリシーはアプリによって決定されます。デフォルト値：2。
pConfig->networkRetryCount = 2;
....// その他の設定。
// プレーヤーに設定を適用します。
mPlayerPtr->setConfig(pConfig);

キャッシュ制御はプレーヤーにとって非常に重要です。適切な設定により、起動を高速化し、カクつきを減らすことができます。ApsaraVideo Player SDK for Windows は、キャッシュと遅延を制御するためのインターフェイスを AVPConfig で提供しています。サンプルコード：

// 設定を取得します。
AVPConfig *pConfig = mPlayerPtr->getConfig();
// 最大遅延時間。注：このパラメーターはライブストリーミングでのみ有効です。遅延が大きい場合、SDK はフレーム同期などの操作を実行して、遅延をこの範囲内に保ちます。
pConfig->maxDelayTime = 5000;
// 最大バッファー時間 (ミリ秒単位)。プレーヤーは一度に指定された時間分のデータを最大でバッファーに読み込みます。
pConfig->maxBufferDuration = 50000;
// 高バッファーウォーターマーク (ミリ秒単位)。ネットワーク状態が悪いためにプレーヤーがデータを読み込んでいる場合、バッファーされたデータがこの時間に達すると読み込み中状態が終了します。
pConfig->highBufferDuration = 3000;
// 開始バッファー時間 (ミリ秒単位)。値が小さいほど起動が速くなります。ただし、再生開始直後にプレーヤーが読み込み中状態になる可能性があります。
pConfig->startBufferDuration = 500;
// その他の設定。
// プレーヤーに設定を適用します。
mPlayerPtr->setConfig(pConfig);

AVPConfig パラメーターを使用して、プレーヤーからのリクエストに HTTP ヘッダーパラメーターを追加できます。サンプルコード：

// 設定を取得します。
AVPConfig *pConfig = mPlayerPtr->getConfig();
// ヘッダーを設定します。
pConfig->headerCount = 1;
pConfig->httpHeaders = new char *[pConfig->headerCount];
// たとえば、HTTPDNS を使用する場合は、Host を設定する必要があります。
pConfig->httpHeaders[0] = strdup("Host:example.com");
....// その他の設定。
// プレーヤーに設定を適用します。
mPlayerPtr->setConfig(pConfig);

ApsaraVideo Player SDK for Windows は、再生中にコンテンツをキャッシュできるローカルキャッシュ機能を提供します。この機能により、ユーザーがビデオを繰り返し再生する際のデータトラフィックを節約できます。この機能を実装するには、`prepare` メソッドを呼び出す前に、プレーヤーの AVPCacheConfig を設定します。サンプルコード：

AVPCacheConfig mCacheConfig;
// キャッシュ機能を有効にします。
mCacheConfig.enable = true;
// キャッシュ可能な単一ファイルの最大時間。この時間を超えるファイルはキャッシュされません。
mCacheConfig.maxDuration = 100;
// キャッシュディレクトリの最大サイズ。サイズ制限を超えた場合、最も古いキャッシュファイルが削除されます。
mCacheConfig.maxSizeMB = 200;
// キャッシュディレクトリのパス。これを、ご利用のアプリの目的のパスに置き換えてください。
mCacheConfig.path = strdup("ご利用のキャッシュパスをここに入力してください");
// プレーヤーにキャッシュ設定を適用します。
mPlayerPtr->setCacheConfig(&mCacheConfig);

setCacheConfig を設定した場合、ビデオが正常にキャッシュされた後、次の状況でキャッシュファイルが使用されます。

• ループ再生が有効な場合、2回目のループからキャッシュファイルが自動的に再生に使用されます。

• ビデオが正常にキャッシュされた後、新しいプレーヤーを作成して同じリソースを再生する場合も、キャッシュファイルが自動的に使用されます。

  重要

  VID ベースの再生の場合、プレーヤーはオンラインリクエストからビデオ ID (VID) などの情報を使用してキャッシュファイルを特定します。したがって、プレーヤーはネットワークリクエストから情報を受信した後にのみ、使用するキャッシュファイルを決定できます。

再生中のキャッシュ機能には、次の条件が適用されます：

• UrlSource を使用した再生の場合、HLS (M3U8) ストリームはキャッシュされません。その他のサポートされている形式は、キャッシュ設定に従ってキャッシュされます。

• VidAuth または VidSts を使用した再生の場合、ビデオはキャッシュ設定に従ってキャッシュされます。

• キャッシュは、プレーヤーがすべてのデータを読み取った後にのみ成功と見なされます。ダウンロードが完了する前に stop メソッドを呼び出すか、onError イベントが発生した場合、キャッシュ処理は失敗します。

• キャッシュされたコンテンツ内でのシークは、キャッシュ結果に影響しません。キャッシュされたコンテンツ外へのシークは、キャッシュ処理の失敗を引き起こします。

• セキュリティファイルがアプリ情報と一致しない場合、キャッシュ処理は失敗します。

• キャッシュの結果は onPlayerEvent コールバックで返されます。コールバックには EVENT_PLAYER_CACHE_SUCCESS と EVENT_PLAYER_CACHE_ERROR が含まれます。

ApsaraVideo Player SDK for Windows は、ApsaraVideo VOD ビデオのダウンロード機能を提供します。この機能により、ユーザーはビデオをローカルにキャッシュして、ApsaraVideo Player でオフライン視聴できます。通常ダウンロードとセキュアダウンロードの2つのダウンロードモードが利用可能です。

• 通常ダウンロード

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

• セキュアダウンロード

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