ApsaraVideo VOD:基本機能

データソース (DataSource) の設定

• ApsaraVideo Player SDK for Android は、VidAuth (ApsaraVideo VOD ユーザーに推奨)、VidSts、UrlSource、暗号化再生の 4 つのビデオオンデマンド (VOD) 再生メソッドをサポートしています。

• ApsaraVideo Player SDK for Android は、UrlSource と暗号化再生の 2 つのライブストリーミング再生メソッドをサポートしています。

VOD 再生

VidAuth vidAuth = new VidAuth();
   vidAuth.setVid("The video ID.");// 必須。 ビデオ ID。
   vidAuth.setPlayAuth("<yourPlayAuth>");// 必須。 再生認証情報。 ApsaraVideo VOD の GetVideoPlayAuth 操作を呼び出して認証情報を生成する必要があります。
   vidAuth.setRegion("The region where ApsaraVideo VOD is activated.");// このパラメーターは ApsaraVideo Player SDK V5.5.5.0 以降では非推奨です。 プレーヤーが自動的に解析するため、リージョンを設定する必要はありません。 V5.5.5.0 より前のバージョンでは、このパラメーターは必須です。 ApsaraVideo VOD が有効化されているリージョン。 デフォルト値: cn-shanghai。
   // vidAuth.setAuthTimeout(3600);// 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定されている URL 署名の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値の 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL が期限切れにならないように、有効期間が実際のビデオの長さよりも長くなるようにしてください。
        
   // ApsaraVideo VOD コンソールで HLS 暗号化パラメーターのパススルーを有効にし、デフォルトのパラメーター名が MtsHlsUriToken である場合は、config を設定して vid に渡す必要があります。 詳細については、次のコードをご参照ください。
   VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
   vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
   vidAuth.setPlayerConfig(config);
   aliPlayer.setDataSource(vidAuth);

VidSts vidSts = new VidSts();
       vidSts.setVid("The video ID.");// 必須。 ビデオ ID。
       vidSts.setAccessKeyId("<yourAccessKeyId>");// 必須。 一時的な AccessKey ペアの AccessKey ID。 STS の AssumeRole 操作を呼び出して AccessKey ID を生成する必要があります。
       vidSts.setAccessKeySecret("<yourAccessKeySecret>");// 必須。 一時的な AccessKey ペアの AccessKey Secret。 STS の AssumeRole 操作を呼び出して AccessKey Secret を生成する必要があります。
       vidSts.setSecurityToken("<yourSecurityToken>");// 必須。 STS トークン。 STS の AssumeRole 操作を呼び出してトークンを生成する必要があります。
       vidSts.setRegion("The region where ApsaraVideo VOD is activated.");// 必須。 ApsaraVideo VOD が有効化されているリージョン。 デフォルト値: cn-shanghai。
       // vidSts.setAuthTimeout(3600);// 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定されている URL 署名の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値の 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL が期限切れにならないように、有効期間が実際のビデオの長さよりも長くなるようにしてください。
        
       // ApsaraVideo VOD コンソールで HLS 暗号化パラメーターのパススルーを有効にし、デフォルトのパラメーター名が MtsHlsUriToken である場合は、config を設定して vid に渡す必要があります。 詳細については、次のコードをご参照ください。
       // ApsaraVideo VOD コンソールで HLS 暗号化パラメーターのパススルーを有効にしない場合は、次のコードを統合する必要はありません。
       VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
       vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
       vidSts.setPlayerConfig(config);
       aliPlayer.setDataSource(vidSts);

 UrlSource urlSource = new UrlSource();
        urlSource.setUri("The playback URL.");// 必須。 再生 URL。 URL は、サードパーティの VOD URL、ApsaraVideo VOD の再生 URL、またはローカルビデオアドレスにすることができます。
        aliPlayer.setDataSource(urlSource);

ライブストリーミング再生

詳細については、「標準ライブストリーミング再生」をご参照ください。

再生の制御

ApsaraVideo Player SDK for Android は、指定した時間からの再生開始、再生開始、再生の一時停止、再生の停止などの操作をサポートしています。

再生の準備

aliPlayer.prepare();

再生を開始する

aliPlayer.start();

指定した時間からの再生開始

// position はミリ秒単位の指定時間です。
aliPlayer.seekTo(long position);

// プレーヤーの次の prepare 呼び出しの開始時刻をミリ秒単位で設定します。 この設定は、直後の prepare 呼び出しに対してのみ有効です。
// prepare を呼び出すと、この値は自動的にゼロにリセットされます。 次の prepare 呼び出しの前にこのメソッドを再度呼び出さない場合、再生は通常の方法で開始されます。
// seekMode を正確または不正確なモードに設定できます。
aliPlayer.setStartTime(time, seekMode);

再生を一時停止する

aliPlayer.pause();

再生を再開する

aliPlayer.start();

再生を停止する

aliPlayer.stop();

プレーヤーを破棄する

//同期破棄。 stop メソッドが自動的に呼び出されます。
aliPlayer.release();
//非同期破棄。 stop メソッドが自動的に呼び出されます。
aliPlayer.releaseAsync();	

プレーヤーの状態の監視

ApsaraVideo Player SDK for Android を使用すると、プレーヤーリスナーを設定し、プレーヤーの状態をリッスンできます。

プレーヤーリスナーの設定

aliPlayer.setOnErrorListener(new IPlayer.OnErrorListener() {
    //プレーヤーの使用中にエラーが発生した場合に、このコールバックが呼び出されます。

    @Override
    public void onError(ErrorInfo errorInfo) {
        ErrorCode errorCode = errorInfo.getCode(); //エラーコード。
        String errorMsg = errorInfo.getMsg(); //エラーの説明。
        //errorExtra は、JSON 文字列形式の追加のエラー情報を示します。 例: ModuleCode は errorCode と完全に同等ではないことに注意してください。
        //{ "Url": "xxx",
   		//	"Module": "NetWork",
    	//	"ModuleCode": "-377",
   		//  "ModuleMessage": "Redirect to a url that is not a media"}
        String errorExtra= errorInfo.getExtra();         
        //エラーが発生した後、プレーヤーを停止する必要があります。
        aliPlayer.stop();
    }
});
aliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    // aliPlayer.prepare() メソッドを呼び出すと、プレーヤーはデータの読み取りと解析を開始します。 操作が成功すると、このコールバックが呼び出されます。

    @Override
    public void onPrepared() {
        // 準備が完了しました。
    }
});
aliPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    //再生が完了すると、このコールバックが呼び出されます。
    @Override
    public void onCompletion() {
        //stop を呼び出してビデオ再生を停止できます。
        aliPlayer.stop();
    }
});
aliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    //現在の進行状況やバッファリングされた位置など、プレーヤーに関する情報。
    @Override
    public void onInfo(InfoBean infoBean) {
        InfoCode code = infoBean.getCode(); //情報コード。
        String msg = infoBean.getExtraMsg();//情報コンテンツ。
        long value = infoBean.getExtraValue(); //情報値。

        //現在の進行状況: InfoCode.CurrentPosition
        //現在のバッファリング位置: InfoCode.BufferedPosition
    }
});
aliPlayer.setOnLoadingStatusListener(new IPlayer.OnLoadingStatusListener() {
    //プレーヤーの読み込みステータス。 ネットワークが貧弱な場合、これは読み込み画面を表示するために使用されます。

    @Override
    public void onLoadingBegin() {
        //読み込みが開始されます。 ビデオとオーディオは再生の準備ができていません。
        //ここに読み込みサークルを表示できます。
    }

    @Override
    public void onLoadingProgress(int percent, float netSpeed) {
        //読み込みの進行状況。 パーセンテージとネットワーク速度。
        //ネットワーク速度は予約済みのフィールドであり、一時的に 0 です。
    }

    @Override
    public void onLoadingEnd() {
        //読み込みが完了しました。 ビデオとオーディオは再生の準備ができています。
        //ここで読み込みサークルを非表示にできます。
    }
});

再生ステータスのリッスン

aliPlayer.setOnStateChangedListener(new IPlayer.OnStateChangedListener() {
    @Override
    public void onStateChanged(int newState) {
        /*
          int idle = 0;
          int initalized = 1;
          int prepared = 2;
          int started = 3;
          int paused = 4;
          int stopped = 5;
          int completion = 6;
          int error = 7;
      */
    }
});

表示モードの設定

ApsaraVideo Player SDK for Android は、塗りつぶし、回転、ミラーなどの表示設定をサポートしています。

塗りつぶし

// モードをアスペクト比フィットに設定します。 ビデオは、画像を変形させることなく、ビュー内に収まるように縮小されます。
aliPlayer.setScaleMode(ScaleMode.SCALE_ASPECT_FIT);
// モードをアスペクト比フィルに設定します。 ビデオは、画像を変形させることなく、ビューを埋めるように拡大されます。
aliPlayer.setScaleMode(ScaleMode.SCALE_ASPECT_FILL);
// モードをストレッチして塗りつぶしに設定します。 ビデオのアスペクト比がビューのアスペクト比と一致しない場合、画像は変形します。
aliPlayer.setScaleMode(ScaleMode.SCALE_TO_FILL);

回転

// 画像を時計回りに 0 度回転させます。
aliPlayer.setRotateMode(RotateMode.ROTATE_0);
// 画像を時計回りに 90 度回転させます。
aliPlayer.setRotateMode(RotateMode.ROTATE_90);
// 画像を時計回りに 180 度回転させます。
aliPlayer.setRotateMode(RotateMode.ROTATE_180);
// 画像を時計回りに 270 度回転させます。
aliPlayer.setRotateMode(RotateMode.ROTATE_270);
// 回転角度を取得します。
aliPlayer.getRotateMode();

ミラー

// モードをミラーなしに設定します。
aliPlayer.setMirrorMode(MirrorMode.MIRROR_MODE_NONE);
// モードを水平ミラーに設定します。
aliPlayer.setMirrorMode(MirrorMode.MIRROR_MODE_HORIZONTAL);
// モードを垂直ミラーに設定します。
aliPlayer.setMirrorMode(MirrorMode.MIRROR_MODE_VERTICAL);

再生情報の取得

ApsaraVideo Player SDK for Android は、現在の再生進行状況、再生時間、バッファリング進行状況などの情報へのアクセスを提供します。

現在の再生進行状況の取得

aliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CurrentPosition){
            // extraValue はミリ秒単位の現在の再生進行状況です。
            long extraValue = infoBean.getExtraValue();
        }
    }
});

再生時間の取得

long duration = aliPlayer.getDuration();

実際の再生時間の取得

long duration = aliPlayer.getPlayedDuration();

バッファリング進行状況の取得

aliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.BufferedPosition){
            // extraValue パラメーターはバッファリングの進行状況を示します。 単位: ミリ秒。
            long extraValue = infoBean.getExtraValue();
        }
    }
});

リアルタイムレンダリングフレームレート、オーディオとビデオのビットレート、およびネットワークダウンロードビットレートの取得

// 現在のレンダリングフレームレートを取得します。 返されるデータは FLOAT データ型です。
aliPlayer.getOption(IPlayer.Option.RenderFPS);
// 現在のビデオビットレートを取得します。 返されるデータは FLOAT データ型です。 単位: bit/s。
aliPlayer.getOption(IPlayer.Option.VideoBitrate);
// 現在のオーディオビットレートを取得します。 返されるデータは FLOAT データ型です。 単位: bit/s。
aliPlayer.getOption(IPlayer.Option.AudioBitrate);
// 現在のネットワークダウンリンクビットレートを取得します。 返されるデータは FLOAT データ型です。 単位: bit/s。
aliPlayer.getOption(IPlayer.Option.DownloadBitrate);

オーディオとビデオの非同期のコールバック

aliPlayer.setOnAVNotSyncStatusListener(new IPlayer.OnAVNotSyncStatusListener() {
    @Override
    public void onAVNotSyncStart(int type) {
        if (type == 0) {
            // より低い再生速度を設定します。
            if (aliPlayer.getSpeed() > 1) {
                aliPlayer.setSpeed(1);
            }
        }
        Toast.makeText(getContext(), "Out-of-sync starts" , Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onAVNotSyncEnd() {
        Toast.makeText(getContext(), "Out-of-sync ends" , Toast.LENGTH_SHORT).show();
    }
});

ボリュームの設定

ボリュームの設定には、ボリュームの調整と再生のミュートが含まれます。

音量の調整

// ボリュームは 0 から 2 までの実数です。
aliPlayer.setVolume(1f);
// ボリュームを取得します。
aliPlayer.getVolume();

再生のミュート

aliPlayer.setMute(true);

再生速度の設定

// 再生速度を設定します。 サポートされている速度範囲は 0.5 から 5.0 です。 速度は 0.5、1.0、1.5 のように 0.5 の倍数で設定することをお勧めします。
aliPlayer.setSpeed(1.0f);

複数の解像度の設定

UrlSource を使用したライブストリーミング

詳細については、「標準ライブストリーミング再生」をご参照ください。

Vid (VidAuth または VidSts) を使用した VOD 再生

Vid ベースの再生 (VidAuth または VidSts) を使用する場合、追加の設定は必要ありません。ApsaraVideo Player SDK for Android は、ApsaraVideo VOD から解像度リストを取得します。

解像度の取得

ビデオがロードされた後、ビデオの解像度を取得できます。

//メディアアセットのすべてのストリーム情報を取得します。
List<TrackInfo> trackInfos = aliPlayer.getMediaInfo().getTrackInfos();
//ストリームを走査し、解像度を取得します。
for (TrackInfo trackInfo : trackInfos) {
     if(trackInfo.getType() == TrackInfo.Type.TYPE_VOD){
             //ビデオの解像度を取得します。
        String vodDefinition = trackInfo.getVodDefinition();
     }
}

解像度の切り替え

selectTrack メソッドを呼び出して解像度を切り替えることができます。対応する TrackInfo のインデックスをパラメーターとして渡します。

aliPlayer.selectTrack(index);

解像度切り替えの通知

SDK は、解像度の切り替えが成功した場合と失敗した場合のコールバックを提供します。

aliPlayer.setOnTrackChangedListener(new IPlayer.OnTrackChangedListener() {
    @Override
    public void onChangedSuccess(TrackInfo trackInfo) { }

    @Override
    public void onChangedFail(TrackInfo trackInfo, ErrorInfo errorInfo) { }
});

高速切り替えモード

高速切り替えモードを有効にすると、selectTrack の手動呼び出しは高速な応答を受け取ります。

PlayerConfig config = aliPlayer.getConfig();
config.mSelectTrackBufferMode = 1;
aliPlayer.setConfig(config)

ループ再生の有効化

aliPlayer.setLoop(true);

aliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        if (infoBean.getCode() == InfoCode.LoopingStart){
            // ループ再生が開始されたときのイベントをリッスンします。
        }
    }
});

オーディオトラックの切り替え

ApsaraVideo Player SDK for Android は、音声トラックを切り替える機能を提供します。これは、多言語音声付きのビデオを視聴する際に、ユーザーが異なる言語を切り替えることができるシナリオに適用されます。

例

1. コールバックを設定します。

   aliPlayer.setOnSubTrackReadyListener(new IPlayer.OnSubTrackReadyListener() {
       @Override
       //onSubTrackReady コールバックは通常、prepare コールバックの前にトリガーされます。
       public void onSubTrackReady(MediaInfo mediaInfo) {
           if (mPlayerTrackFragment != null) {
               //mPlayerTrackFragment.showMediaInfo();
               //getSubMediaInfo を呼び出して MediaInfo 情報を取得できます。 このメソッドは、onSubTrackReady コールバックを受信した後にのみ呼び出すことができます。 それ以外の場合は、null が返されます。
               MediaInfo subMediaInfo = aliPlayer.getSubMediaInfo();
               TrackInfos = subMediaInfo.getTrackInfos();
               //選択するトラックを決定します。
               myTrack = myfunc(TrackInfos)
           }
       }
   });

2. オーディオトラックを切り替えます。

   index = myTrack.getIndex();
   aliPlayer.selectTrack(index);

サムネイルの使用

ApsaraVideo Player SDK でサムネイルを使用する前に、ビデオにサムネイルが設定されていることを確認してください。これには、ビデオのスプライトが生成されている必要があります。ApsaraVideo VOD コンソールで、スプライトスクリーンショットテンプレートを作成します。次に、ワークフローを使用して、スプライトスクリーンショットテンプレートでビデオを処理し、スプライトデータを生成します。詳細については、「ビデオスクリーンショット」をご参照ください。次の例は、ApsaraVideo Player SDK でサムネイルを使用する方法を示しています。

mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        //1. サムネイル URL を取得します。
        List<Thumbnail> thumbnailList = mAliPlayer.getMediaInfo().getThumbnailList();
        //2. サムネイルヘルパークラスを作成します。
        ThumbnailHelper mThumbnailHelper = new ThumbnailHelper(thumbnailList.get(0).mURL);
        //3. リスナーを設定します。
        mThumbnailHelper.setOnPrepareListener(new ThumbnailHelper.OnPrepareListener() {
            @Override
            public void onPrepareSuccess() {
                //5. サムネイルがロードされた後、指定した位置のサムネイルをリクエストできます。
            }
            @Override
            public void onPrepareFail() {}
        });

        mThumbnailHelper.setOnThumbnailGetListener(new ThumbnailHelper.OnThumbnailGetListener() {
            @Override
            public void onThumbnailGetSuccess(long positionMs, ThumbnailBitmapInfo thumbnailBitmapInfo) {
                //6. 指定した位置のサムネイルのビットマップを取得します。
                Bitmap thumbnailBitmap = thumbnailBitmapInfo.getThumbnailBitmap();
            }
            @Override
            public void onThumbnailGetFail(long positionMs, String errorMsg) {}
        });

        //4. サムネイルをロードします。
        mThumbnailHelper.prepare();
    }
});

注: URL ベースの再生を使用する場合、AliPlayer は ThumbnailList を取得できない場合があります。サムネイル URL を直接指定してください。

mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        //1. サムネイルヘルパークラスを作成します。
        ThumbnailHelper mThumbnailHelper = new ThumbnailHelper(URL);
        //2. リスナーを設定します。
        mThumbnailHelper.setOnPrepareListener(new ThumbnailHelper.OnPrepareListener() {
            @Override
            public void onPrepareSuccess() {
                //4. サムネイルがロードされた後、指定した位置のサムネイルをリクエストできます。
            }
            @Override
            public void onPrepareFail() {}
        });

        mThumbnailHelper.setOnThumbnailGetListener(new ThumbnailHelper.OnThumbnailGetListener() {
            @Override
            public void onThumbnailGetSuccess(long positionMs, ThumbnailBitmapInfo thumbnailBitmapInfo) {
                //5. 指定した位置のサムネイルのビットマップを取得します。
                Bitmap thumbnailBitmap = thumbnailBitmapInfo.getThumbnailBitmap();
            }
            @Override
            public void onThumbnailGetFail(long positionMs, String errorMsg) {}
        });

        //3. サムネイルをロードします。
        mThumbnailHelper.prepare();
    }
});

SDK ログの取得

ApsaraVideo Player SDK の実行中に、詳細なログ情報が生成されます。これには、ネットワークリクエストのステータス、システムコールの結果、権限リクエストなどが含まれます。これにより、開発者はコードのデバッグや問題のトラブルシューティングを行い、開発効率を向上させることができます。

方法 1: 開発ツールのコンソールから SDK ログを取得する

この方法は、問題をローカルで再現してログをキャプチャできるシナリオに適用されます。

1. ログを有効にし、ログレベルを設定します。

   // Logger は com.cicada.player.utils にあります。
   // ログを有効にします。
   Logger.getInstance(context).enableConsoleLog(true);
   // ログレベルを設定します。 デフォルト値: AF_LOG_LEVEL_INFO。 問題をトラブルシューティングするには、レベルを AF_LOG_LEVEL_TRACE に設定できます。
   Logger.getInstance(context).setLogLevel(Logger.LogLevel.AF_LOG_LEVEL_INFO);

2. フレームレベルのログを設定します。

   //フレームレベルのログ出力を設定します。
   //オプションの値が 0 の場合は機能が無効であることを示し、値が 1 の場合は機能が有効であることを示します。
   Logger.getInstance(this).setLogOption(Logger.LogOption.FRAME_LEVEL_LOGGING_ENABLED,value);

   説明

   フレームレベルのログ機能は、主にトラブルシューティングに使用されます。

3. ログを収集します。

   問題を再現した後、Logcat などの開発ツールのコンソールからログを取得できます。

方法 2: LogCallback を使用して SDK の出力ログをリッスンする

この方法は、ユーザー側で問題が発生し、ローカルで再現してログをキャプチャできないシナリオに適用されます。LogCallback を使用して SDK の出力ログをリッスンし、アプリのログチャネルに自動的に出力できます。

1. ログを有効にし、ログレベルを設定します。

   // Logger は com.cicada.player.utils にあります。
   // ログレベルを設定します。 デフォルト値: AF_LOG_LEVEL_INFO。 問題をトラブルシューティングするには、レベルを AF_LOG_LEVEL_TRACE に設定できます。
   Logger.getInstance(context).setLogLevel(Logger.LogLevel.AF_LOG_LEVEL_INFO);
   Logger.getInstance(mContext).setLogCallback(newLogger.OnLogCallback(){
           @Override
           public void onLog(Logger.LogLevel logLevel,Strings){
               // ログ
           }
   });

2. ログを収集します。

   問題を再現した後、ログはアプリのログチャネルを介してアプリのログファイルに自動的に出力されます。

参考資料

• 詳細な API の説明については、「API リファレンス」をご参照ください。

• 高度な機能の使用方法の詳細については、「高度な機能」をご参照ください。

• 再生例外に関する一般的な問題と解決策については、「再生例外のトラブルシューティング」、「ApsaraVideo Player for Android に関するよくある質問」、および「モバイルのエラーコード」をご参照ください。