ApsaraVideo VOD:Android プレーヤーのよくある質問

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

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

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

生の音声・映像データを取得するには、ソフトウェアデコードに切り替えて、暗号化されていない動画を再生します。次のコードに例を示します。

// ソフトウェアデコードに切り替えます。
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) {
  
      }
  });

• トラックメソッドを使用して取得できます。

  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);

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

// 単位：ミリ秒。
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);