ApsaraVideo VOD:Android プレーヤーに関するよくある質問

デフォルトでは、プレーヤー SDK は 500 ms ごとに再生進捗のコールバックを提供します。このコールバック間隔は変更できます。現在の再生進捗をより頻繁に取得するには、間隔を短くします。次のコードに例を示します。

// コールバック間隔を変更します。
PlayerConfig config = mAliyunLivePlayer.getConfig();
config.mPositionTimerIntervalMs = 100;// コールバック間隔 (ms)。
mAliyunLivePlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
        @Override
        public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CurrentPosition){
            // 現在の再生進捗。
            long currentPosition = infoBean.getExtraValue();
        }
    }
});

RAW オーディオデータとビデオデータを取得するには、ソフトウェアデコードに切り替えて、暗号化されていないビデオを再生します。次のコードに例を示します。

// ソフトウェアデコードに切り替えます。
mAliPlayer.enableHardwareDecoder(false);
IPlayer.RenderFrameCallbackConfig renderFrameCallbackConfig = new IPlayer.RenderFrameCallbackConfig();
// 基になるビデオデータアドレスのみを返すかどうかを指定します。デフォルト値: true。
renderFrameCallbackConfig.mVideoDataAddr = false;
// 基になるオーディオデータアドレスのみを返すかどうかを指定します。デフォルト値: false。
renderFrameCallbackConfig.mAudioDataAddr = false;
mAliPlayer.setRenderFrameCallbackConfig(renderFrameCallbackConfig);

mAliPlayer.setOnRenderFrameCallback(new IPlayer.OnRenderFrameCallback() {
    @Override
    public boolean onRenderFrame(FrameInfo frameInfo) {
        return false;
    }
});

ビデオの幅と高さは、次の 3 つの方法のいずれかで取得できます。

• AliPlayer インスタンスが `prepare` メソッドを完了し、`prepared` 状態になった後、次のメソッドを使用して幅と高さを取得できます。

  mAliyunPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
      @Override
      public void onPrepared() {
            mAliyunPlayer.getVideoWidth();
                mAliyunPlayer.getVideoHeight();
      }
  });

• ビデオサイズの変更コールバックをリッスンします。

  mAliyunPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
      @Override
      public void onVideoSizeChanged(int width, int height) {
  
      }
  });

• `track` メソッドを使用して幅と高さを取得します。

  mAliyunPlayer.setOnTrackReadyListener(new IPlayer.OnTrackReadyListener() {
      @Override
      public void onTrackReady(MediaInfo mediaInfo) {
      List<TrackInfo> trackInfos = mediaInfo.getTrackInfos();
          for (TrackInfo trackInfo : trackInfos) {
          if(trackInfo.getType() == TrackInfo.Type.TYPE_VIDEO){
          trackInfo.getVideoWidth();
          trackInfo.getVideoHeight();
          }
      }
      }
  });

mAliPlayer.selectTrack(TrackInfo.AUTO_SELECT_INDEX) インターフェイスを呼び出して自動ビットレート切り替えを有効にすると、プレーヤー SDK は現在のネットワーク速度を計算します。ネットワーク速度が次のビットレートレベルを 10 秒間サポートできる場合、プレーヤーはそのビットレートに切り替えます。それ以外の場合、プレーヤーは切り替えません。

• 高ビットレートから低ビットレートに切り替える場合、プレーヤーはキャッシュされた高ビットレートのコンテンツが再生された後に切り替えを行います。この切り替えは、ネットワーク速度が 10 秒間、より低いビットレートのレベルまで低下した場合に発生します。

• 低ビットレートから高ビットレートに切り替える場合、プレーヤーはすぐに切り替えます。この切り替えは、ネットワーク速度が 10 秒間、次のビットレートレベルまで増加した場合に発生します。

自動ビットレート切り替えを有効にするには、まずコンソールでビデオをアダプティブビットレートストリームにトランスコードする必要があります。次に、プレーヤーがアダプティブビットレートストリームを取得するように指定します。次のコードは、VidAuth 再生メソッドを使用する例を示しています。

VidAuth vidAuth = new VidAuth();
List<Definition> list = new ArrayList<>();
list.add(Definition.DEFINITION_AUTO);
vidAuth.setDefinition(list);

リトライロジックはカスタマイズできます。リトライがトリガーされると、リトライイベントが外部サービスに送信され、そこで特定のリトライロジックが決定されます。次のコードに例を示します。

PlayerConfig config = mAliPlayer.getConfig();
// 1. リトライ回数を設定します。この例では、0 に設定されています。
config.mNetworkRetryCount = 0;
mAliPlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        // 2. リトライイベントをリッスンします。
       if(infoBean.getCode() == InfoCode.NetworkRetry){
            // TODO: 必要に応じてロジックを処理します。
        }
    }
});

次のコードは、シークモードを切り替える方法を示しています。

// 不正確なシーク。
mAliPlayer.seekTo(1000);
mAliPlayer.seekTo(1000, IPlayer.SeekMode.Inaccurate);
// 正確なシーク。
mAliPlayer.seekTo(1000,IPlayer.SeekMode.Accurate);

ソリューション: インターフェイスを使用して、正確なシークの最大間隔を設定できます。最大間隔を長くすると、正確なシークが不正確なシークに切り替わる頻度が減り、シークの精度が向上します。ただし、間隔が長いと、シークポイントがキーフレームから遠い場合にシーク操作に時間がかかります。ビジネスニーズに基づいて、正確なシークの最大間隔を合理的に設定する必要があります。次のコードに例を示します。

// 単位: ms。
mAliPlayer.setMaxAccurateSeekDelta(10000);

次のように問題をトラブルシューティングします。

1. CPU アーキテクチャが x86 かどうかを確認します。

   プレーヤー SDK は arm64-v8a と armeabi-v7a アーキテクチャのみをサポートしています。x86 アーキテクチャはサポートしていません。

2. プロジェクトにプレーヤー SDK の .so ファイルと Maven 依存関係の両方が統合されているかどうかを確認します。

   たとえば、`build.gradle` で Maven 依存関係を使用してプレーヤー SDK を統合し、さらにプロジェクトのモジュールの `libs` ディレクトリにプレーヤー関連の動的ライブラリを統合している場合があります。

   推奨されるソリューション: 両方の方法を使用している場合は、動的ライブラリを削除し、Maven 依存関係のみを使用してください。動的ライブラリを統合する必要がある場合は、すべてのプレーヤー SDK 関連の .so ファイルが同じバージョンであることを確認してください。プレーヤー SDK の統合方法と動的ライブラリの取得方法については、「SDK の統合」をご参照ください。次の図は、プレーヤー関連の動的ライブラリを示しています。

3. 部分的なパッケージを統合した場合、AlivcFFmpeg のバージョン依存関係が正しいことを確認します。

   AlivcFFmpeg のバージョン依存関係については、「AlivcFFmpeg のバージョン依存関係」をご参照ください。

次のように問題をトラブルシューティングします。

1. クラッシュがプレーヤー SDK 内で発生したかどうかを確認します。

   AliyunPlayer プレフィックスを持つクラッシュスタックを確認します。このプレフィックスを持つスタックが存在する場合、問題はプレーヤー SDK にあります。

2. プレーヤー SDK の最新バージョンにアップグレードし、問題が修正されているか確認します。

3. 問題が解決しない場合は、関連するクラッシュファイル (すべてのスレッドを含む)、クラッシュログ、およびクラッシュシナリオの情報を準備します。詳細については、「問題ログの取得方法」をご参照ください。

次のように問題をトラブルシューティングします。

1. ソースビデオ自体に黒枠があるかどうかを確認します。

2. 次のインターフェイスを使用して、プレーヤーのスケーリングモードを調整できます。

   /*
   SCALE_ASPECT_FILL: 画面に比例して塗りつぶします。ビデオはトリミングされます。
   SCALE_ASPECT_FIT: ビデオを比例してスケーリングします。黒枠が表示されることがあります。
   SCALE_TO_FILL: 比率を維持せずに画面を塗りつぶします。ビデオは歪みます。
   */
   mAliPlayer.setScaleMode();

3. スケーリングモードがニーズに合わない場合は、アプリケーション層で SurfaceView または TextureView のサイズを調整できます。

次のように問題をトラブルシューティングします。

1. 別のプレーヤーでビデオを再生し、オーディオのみのファイルかどうかを確認します。

2. ビデオをレンダリングするビューが正しく設定されていることを確認します。たとえば、プレーヤーに表示ビューが設定されているか、再生インターフェイスから削除されているかを確認します。表示ビューの設定手順については、「基本機能」の [ステップ 4] をご参照ください。

次のように問題をトラブルシューティングします。

1. CPU アーキテクチャが要件を満たしているか確認します。

   プレーヤー SDK は、arm64-v8a および armeabi-v7a アーキテクチャの動的ライブラリのみをサポートしています。

2. プレーヤー SDK のバージョンが古すぎないか確認します。

   プレーヤー SDK V5.4.6.0-full 以前を使用している場合は、V5.4.6.0-full-15467853 以降のバージョンにアップグレードすることをお勧めします。プレーヤー SDK の最新および過去のバージョンについては、「Android SDK リリースノート」をご参照ください。

V5.4.5.0 より前のバージョンのプレーヤー SDK は、リストプレーヤー AliListPlayer を使用した HLS (m3u8) ビデオの再生をサポートしていません。V5.4.5.0 以降、HLS (m3u8) ビデオがサポートされています。ただし、ローカルキャッシュを有効にする必要があります。ローカルキャッシュを有効にする方法については、「ローカルキャッシュ」をご参照ください。

次のコードに例を示します。

// VidSts 再生メソッドを例として使用します。
VidSts vidSts = new VidSts();
// vid、AccessKeyId、AccessKeySecret、token などのパラメーターを設定するコードは省略されています。詳細については、「基本機能」トピックのプレーヤー作成設定をご参照ください。
/*
    パラメーター 1: 希望する再生解像度。有効な値: FD、LD、SD、HD、2K、4K、OD。
    パラメーター 2: 希望する解像度の再生を強制するかどうかを指定します。false: 希望する解像度の再生を強制しません。プレーヤー SDK はデフォルトの順序に基づいて再生する解像度を検索します。true: 希望する解像度の再生を強制します。希望する解像度が見つからない場合、ビデオは再生されません。
*/
vidSts.setQuality("",false);