ApsaraVideo VOD:複数のビデオソースのサポート

ビデオソース

ビデオソースとは、動画再生のデータソースです。動画の取得方法と認可方式を定義します。

AliPlayerKit は、次の 3 種類のビデオソースをサポートしています：

ビデオソースタイプの選択方法

ビジネスシナリオとセキュリティ要件に基づいて、ビデオソースタイプを選択します：

課題

• ビデオソースの種類ごとに設定方法が統一されていません。

• 認可のための認証情報の管理が複雑です。

• ビデオソースに対する統一された検証メカニズムがありません。

• さまざまな種類のビデオリソースを区別することが困難です。

コアバリュー

コア機能

VidAuth モード (推奨)

ビデオ ID (VID) と PlayAuth を使用して再生を認可します。

ユースケース：

• 認可が必要なビデオリソース。

• ほとんどの本番環境におけるビデオ再生。

• シンプルかつ安全な認可方式が必要なシナリオ。

機能：

• シンプルで統合が容易な認可。

• 基本的なセキュリティを提供します。

• ほとんどのビジネスシナリオで推奨します。

パラメーター：

例：

// VidAuth タイプのビデオソースを作成
VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(
    "your_video_id",      // ビデオ ID
    "your_play_auth"      // PlayAuth
);

// プレーヤーモデルを作成
AliPlayerModel model = new AliPlayerModel.Builder()
    .videoSource(videoSource)
    .build(); 

VidSts モード

ビデオ ID (VID) と Alibaba Cloud Security Token Service (STS) のトークンを使用して再生を認可し、強化されたセキュリティとアクセス制御を提供します。

ユースケース：

• 一時的な認証情報が必要なシナリオ。

• 高いセキュリティ要件を持つビデオリソース。

• きめ細かなアクセス制御が必要なシナリオ。

機能：

• 一時的な認証情報を使用し、高いセキュリティを実現します。

• きめ細かなアクセス制御をサポートします。

• 高セキュリティシナリオに適しています。

パラメーター：

例：

// VidSts タイプのビデオソースを作成
VideoSource.VidStsSource videoSource = VideoSourceFactory.createVidStsSource(
    "your_video_id",              // ビデオ ID
    "your_access_key_id",         // アクセスキー ID
    "your_access_key_secret",     // シークレットアクセスキー
    "your_security_token",        // セキュリティトークン
    "cn-shanghai"                 // リージョン (オプション)
);

// プレーヤーモデルを作成
AliPlayerModel model = new AliPlayerModel.Builder()
    .videoSource(videoSource)
    .build();   

URL モード

直接 URL を使用してビデオを再生します。このモードは、公開されているビデオリソースに適しています。

ユースケース：

• 認可が不要な公開ビデオリソース。

• テストおよびデモシナリオ。

• シンプルなビデオ再生要件。

機能：

• 使用が簡単で、ビデオ URL のみが必要です。

• 追加の認可は不要です。

• セキュリティが低く、機密性の高いコンテンツには適していません。

パラメーター：

例：

// URL タイプのビデオソースを作成
VideoSource.UrlSource videoSource = VideoSourceFactory.createUrlSource(
    "https://example.com/video.mp4"
);

// プレーヤーモデルを作成
AliPlayerModel model = new AliPlayerModel.Builder()
    .videoSource(videoSource)
    .build();

基本的な再生フロー

// 1. ビデオソースを作成します (VidAuth モードを推奨します)
VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(
    "your_video_id",
    "your_play_auth"
);

// 2. プレーヤーモデルを作成します
AliPlayerModel model = new AliPlayerModel.Builder()
    .videoSource(videoSource)
    .coverUrl("https://example.com/cover.jpg")
    .videoTitle("Sample Video")
    .sceneType(SceneType.VOD)
    .autoPlay(true)
    .build();

// 3. コントローラーを作成します
AliPlayerController controller = new AliPlayerController(this);

// 4. コントローラーを構成し、プレーヤービューにアタッチします
controller.configure(model);
playerView.attach(controller);   

ビデオソースの切り替え

// 動画を切り替える前に、現在のコントローラーをデタッチします
playerView.detach();

// 新しいビデオソースを作成します
VideoSource.VidAuthSource newSource = VideoSourceFactory.createVidAuthSource(
    "new_video_id",
    "new_play_auth"
);

// 新しいプレーヤーモデルを作成します
AliPlayerModel newModel = new AliPlayerModel.Builder()
    .videoSource(newSource)
    .build();

// 新しいコントローラーを作成してアタッチします
AliPlayerController newController = new AliPlayerController(this);
playerView.attach(newController, newModel);  

ビデオソースの検証

プレーヤーを構成する前に、isValid() メソッドを呼び出して、ビデオソースの設定を検証できます：

VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(vid, playAuth);

if (videoSource.isValid()) {
    // 設定は有効です。続行できます。
    AliPlayerModel model = new AliPlayerModel.Builder()
        .videoSource(videoSource)
        .build();
    playerView.attach(controller, model);
} else {
    // 設定は無効です。パラメーターを確認してください。
    Log.e(TAG, "Invalid video source configuration");
}   

サーバーからの認可の取得

機密データをハードコーディングしないように、サーバーから認可情報を取得します：

// 推奨：サーバーから PlayAuth を取得します
public void playVideo(String videoId) {
    // サーバーから PlayAuth をリクエストします
    apiService.getPlayAuth(videoId, new Callback<PlayAuthResponse>() {
        @Override
        public void onSuccess(PlayAuthResponse response) {
            VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(
                videoId,
                response.getPlayAuth()
            );
            // 再生を開始します...
        }

        @Override
        public void onError(Exception e) {
            Log.e(TAG, "Failed to get playAuth", e);
        }
    });
}   

STS トークンの有効期限切れの処理

VidSts モードでは、セキュリティトークンの有効期限切れを処理します：

// トークンがまもなく失効するかどうかを確認します
if (isTokenExpiringSoon(securityToken)) {
    // トークンを更新します
    refreshSecurityToken(new TokenCallback() {
        @Override
        public void onTokenRefreshed(String newToken) {
            // 新しいトークンを使用してビデオソースを再作成します
            VideoSource.VidStsSource videoSource = VideoSourceFactory.createVidStsSource(
                vid, accessKeyId, accessKeySecret, newToken, region
            );
            // 再生を継続します...
        }
    });
}

ビデオソースタイプの選択

セキュリティの推奨事項

エラー処理

ビデオソースを作成する際は、エラーを処理してください：

try {
    VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(vid, playAuth);

    if (!videoSource.isValid()) {
        // 無効な設定を処理
        showError("Invalid video source configuration");
        return;
    }

    // ビデオソースを使用
    playVideo(videoSource);

} catch (IllegalArgumentException e) {
    // パラメーターエラーを処理
    Log.e(TAG, "Invalid video source parameters", e);
    showError("Parameter error: " + e.getMessage());
}   

例の機能

例の実行

デモアプリで、[ビデオソース] の例を選択して結果を確認してください。

VideoSourceFactory メソッド

VideoSource メソッド

SourceType 定数

MediaId 生成ルール

MediaId により、プレーヤーインスタンスの再利用が可能になります。同じ MediaId を持つビデオソースは、同じプレーヤーインスタンスを共有します。

ビデオソースタイプの選択

• 標準的なセキュリティ要件で、認可が必要なコンテンツの場合：VidAuth モードを使用します (推奨)。

• 高いセキュリティと STS 一時的な認証情報が必要なコンテンツの場合：VidSts モードを使用します。

• 公開動画の場合：URL モードを使用します。

VidAuth と VidSts の比較

作成失敗の処理

以下を確認してください。

1. パラメーターが null または無効かを確認します。

2. URL フォーマットが正しいかを確認します (URL モードの場合)。

3. 認可情報が有効かを確認します (VidAuth および VidSts の場合)。

4. ネットワーク接続が安定しているかを確認します。

よくある間違い

// クライアントで機密情報をハードコーディングしないでください
VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(
    "video_id",
    "hardcoded_play_auth_value"  // セキュリティリスク!
);

// サーバーから認可情報を取得
String playAuth = fetchPlayAuthFromServer(videoId);
VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(videoId, playAuth);

// 検証せずに使用
VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(vid, playAuth);
playerView.attach(controller, createModel(videoSource));  // 設定が無効である可能性があります

// 使用前に検証
VideoSource.VidAuthSource videoSource = VideoSourceFactory.createVidAuthSource(vid, playAuth);

if (videoSource.isValid()) {
    playerView.attach(controller, createModel(videoSource));
} else {
    showError("Invalid video source configuration");
}

// トークンの有効期限切れが処理されていません
VideoSource.VidStsSource videoSource = VideoSourceFactory.createVidStsSource(
    vid, accessKeyId, accessKeySecret, expiredToken, region
);
// 再生が失敗します! トークンの有効期限が切れています。

// トークンの有効性を確認し、必要に応じて更新
if (isTokenExpired(securityToken)) {
    securityToken = refreshToken();
}
VideoSource.VidStsSource videoSource = VideoSourceFactory.createVidStsSource(
    vid, accessKeyId, accessKeySecret, securityToken, region
);

デバッグ

1. ログを確認：tag:AliPlayerKit を使用して Logcat をフィルタリングします。

2. toString() を呼び出す：ビデオソースの toString() メソッドは、機密データがマスクされた設定情報を出力します。

3. パラメーターを検証：isValid() メソッドを使用して設定を検証します。

4. ネットワークを確認：ビデオソースにアクセスできることを確認します。