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

プレーヤーSDKは、デフォルトで 500 ミリ秒ごとに再生進捗を報告します。必要に応じて、コールバック間隔を調整してください。

// コールバック間隔を変更します。
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;
    }
});

動画の幅と高さを取得するには、次のいずれかの方法を使用します。

• AliPlayer インスタンスが 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);

リトライロジックをカスタマイズするには、リトライ回数を 0 に設定し、リトライイベントを外部で処理します。

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 依存関係のみを使用します。動的ライブラリを使用する必要がある場合は、すべての .so ファイルが同じバージョンであることを確認してください。「SDKの統合」をご参照ください。プレーヤーに関連する動的ライブラリファイルは、libalivcffmpeg.so、libsaasCorePlayer.so、libsaasDownloader.soです。

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 以降にアップグレードしてください。「Android SDKのリリースノート」をご参照ください。

リストプレーヤーAliListPlayer は、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);