ApsaraVideo VOD:ApsaraVideo Player SDK for Androidに関するFAQ

デフォルトでは、ApsaraVideo Player SDKは500ミリ秒ごとに現在の再生位置に関するコールバックを返します。 再生位置をより頻繁に取得するために、コールバックが返される間隔を短くすることができます。 サンプルコード：

// Change the callback interval.
PlayerConfig config = mAliyunLivePlayer.getConfig();
config.mPositionTimerIntervalMs = 100; // The callback interval. Unit: milliseconds. 
mAliyunLivePlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
        @Override
        public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CurrentPosition){
            // The current playback position.
            long currentPosition = infoBean.getExtraValue();
        }
    }
});

問題をトラブルシューティングするには、次の手順を実行します。

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

   ApsaraVideo Player SDKは、arm64-v8aおよびarmeabi-v7aアーキテクチャのみをサポートします。 x86アーキテクチャはサポートされていません。

2. 両方が ファイルとMavenの依存関係がプロジェクトに追加されます。

   たとえば、Mavenの依存関係をbuild.gradleファイルに追加してApsaraVideo Player SDKを統合し、SDKの動的ライブラリをlibsディレクトリに同時に追加すると、クラッシュが発生します。

   解決策: Maven依存関係と動的ライブラリの両方がプロジェクトに追加されている場合は、動的ライブラリを削除することをお勧めします。 動的ライブラリをプロジェクトに追加する必要がある場合は、そのため、ファイルは同じSDKバージョンです。 ApsaraVideo Player SDKを統合して動的ライブラリを取得する方法の詳細については、「クイック統合」をご参照ください。 次の図は、ApsaraVideo Player SDKの動的ライブラリを示しています。

3. 部品パッケージを使用してSDKを統合する場合は、AlivcFFmpegの正しいバージョンがプロジェクトに追加されていることを確認してください。

   詳細については、「AlivcFFmpeg依存関係」をご参照ください。

問題をトラブルシューティングするには、次の手順を実行します。

1. ApsaraVideo Player SDKでクラッシュが発生していないか確認します。

   AliyunPlayerというプレフィックスが付いたクラッシュスタック名が存在する場合、ApsaraVideo Player SDKでクラッシュが発生します。

2. ApsaraVideo Player SDKを最新バージョンに更新し、問題が修正されたかどうかを確認します。

3. 問題が解決しない場合は、Alibaba Cloudテクニカルサポートにお問い合わせください。 テクニカルサポートに連絡するときに、すべてのスレッドとクラッシュログに関するファイルを準備し、クラッシュシナリオを記述します。 詳細については、「エラーログを取得するにはどうすればよいですか?」をご参照ください。

問題をトラブルシューティングするには、次の手順を実行します。

1. ビデオソースに黒いバーが表示されていないか確認します。

2. 次の操作を呼び出して、プレーヤーのスケーリングモードを変更します。

   /*
   SCALE_ASPECT_FILL: crops the video to fit the view based on the aspect ratio of the video. 
   SCALE_ASPECT_FIT: scales in the video based on the aspect ratio of the video. Black bars are displayed in the view. 
   SCALE_TO_FILL: stretches the video to fill in the view. Image distortion may occur. 
   */
   mAliPlayer.setScaleMode();

3. スケーリングモードを変更しても問題が解決しない場合は、アプリケーションレイヤーでSurfaceViewまたはTextureViewを呼び出して、ビューのサイズを変更します。

問題をトラブルシューティングするには、次の手順を実行します。

1. 別のプレーヤーでビデオを再生し、ビデオにオーディオのみが含まれているかどうかを確認します。

2. ビューが正しく設定されているかどうかを確認します。 たとえば、ビューが設定されていないか、再生ウィンドウの外に配置されていない場合、この問題が発生します。 ビューの設定方法の詳細については、「プレーヤーの作成」の手順4をご参照ください。

問題をトラブルシューティングするには、次の手順を実行します。

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

   ApsaraVideo Player SDKは、arm64-v8aおよびarmeabi-v7aアーキテクチャのみをサポートします。

2. Apsaravideo Player SDKのバージョンが古いかどうかを確認します。

   使用するApsaraVideo Player SDKのバージョンが5.4.6.0-full以前の場合、SDKを5.4.6.0-full-15467853以降に更新することを推奨します。 ApsaraVideo Player SDKのバージョンの詳細については、「ApsaraVideo Player SDK For Androidのリリースノート」をご参照ください。

ApsaraVideo Player SDK V5.4.5.0以前を使用している場合、AliListPlayerを使用してHLS (M3U8) ビデオを再生することはできません。 ApsaraVideo Player SDK V5.4.5.0以降を使用する場合、HLS (M3U8) ビデオを再生するにはローカルキャッシュを有効にする必要があります。 詳細については、「ローカルキャッシュの設定」をご参照ください。

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

// Switch to the inaccurate seeking mode. 
mAliPlayer.seekTo(1000);
mAliPlayer.seekTo(1000, IPlayer.SeekMode.Inaccurate);
// Switch to the accurate seeking mode. 
mAliPlayer.seekTo(1000,IPlayer.SeekMode.Accurate);

解決策: setMaxAccurateSeekDelta操作を呼び出して、正確な探索モードで許可されている探索位置と最も近いキーフレームとの間の最大間隔を設定します。 このように、シーク精度は改善されるが、応答時間はより長くなる。 ビジネス要件に基づいて最大間隔を設定することを推奨します。 サンプルコード：

// Unit: milliseconds. 
mAliPlayer.setMaxAccurateSeekDelta(1000);

onInfoコールバックでキャッシュ失敗の原因を取得します。 次のサンプルコードは、onInfoコールバックを設定する方法の例を示しています。

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
        @Override
        public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CacheSuccess){
            // Caching during playback succeeded.
        }else if(infoBean.getCode() == InfoCode.CacheError){
            // Caching during playback failed.
            String error = infoBean.getExtraMsg();
        }
    }
});

次の項目は、キャッシュエラーの一般的な原因を示しています。

• CacheConfigで指定されたサイズとデュレーションは、ビデオのサイズと一致しません。

• 再生中に停止またはシークする位置は、バッファの外にあります。

メディアソースデータは、ソフトウェアデコードを使用して暗号化されていないビデオを再生する場合にのみ返されます。 サンプルコード：

// Switch to software decoding. 
mAliPlayer.enableHardwareDecoder(false);
IPlayer.RenderFrameCallbackConfig renderFrameCallbackConfig = new IPlayer.RenderFrameCallbackConfig();
// Specifies whether to return only the address of the underlying video data. Default value: true. 
renderFrameCallbackConfig.mVideoDataAddr = false;
// Specifies whether to return only the address of the underlying audio data. Default value: false. 
renderFrameCallbackConfig.mAudioDataAddr = false;
mAliPlayer.setRenderFrameCallbackConfig(renderFrameCallbackConfig);

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

次のいずれかの方法を使用して、ビデオの高さと幅を取得できます。

• AliPlayerインスタンスでprepareメソッドを呼び出します。 AVPEventPrepareDoneイベントが完了したら、AliPlayerの高さと幅を取得します。 サンプルコード：

  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) を呼び出して自動ビットレート切り替え機能を有効にすると、ApsaraVideo Player SDKはネットワーク速度を監視します。 ビデオのビットレートは、10秒の平均ネットワーク速度に基づいて、より高いビットレートとより低いビットレートとの間で切り替えられる。 10秒の平均ネットワーク速度が条件を満たさない場合、ビデオビットレートは切り替えられません。

• 10秒の平均ネットワーク速度がより低いビットレートの条件を満たす場合、キャッシュされたコンテンツの再生が完了した後、ビデオはより低いビットレートに切り替えられます。

• 10秒の平均ネットワーク速度がより高いビットレートの条件を満たす場合、ビデオはすぐにより高いビットレートに切り替えられます。

自動ビットレート切り替え機能を使用するには、ApsaraVideo VODコンソールを使用してビデオをアダプティブストリームにトランスコードし、アダプティブストリームを再生するプレーヤーを指定する必要があります。 次のサンプルコードは、VidAuthベースの例を示しています。

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

再試行ロジックをカスタマイズし、再試行イベントが発生したときに通知を受け取ることができます。 サンプルコード：

PlayerConfig config = mAliPlayer.getConfig();
// 1. Specify the number of retries. Set the value to 0 in this example. 
config.mNetworkRetryCount = 0;
mAliPlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        // 2. Listen to the retry event. 
       if(infoBean.getCode() == InfoCode.NetworkRetry){
            // Configure the retry logic. 
        }
    }
});

問題をトラブルシューティングするには、次の手順を実行します。

1. AliyunPlayer、AlivcArtc、およびRtsの依存関係が追加されているかどうかを確認します。

   ApsaraVideo Playerを使用してリアルタイムストリーミング (Rts) ストリームを再生する前に、AliyunPlayer、AlivcArtc、およびRTSの依存関係を追加する必要があります。 詳細については、「Native RTS SDK For Android」をご参照ください。

2. RTS SDKとApsaraVideo Player SDKのバージョンが一致するかどうかを確認します。

   RTS SDKでサポートされているバージョンのApsaraVideo Player SDKを使用する必要があります。 詳しくは、「SDK のダウンロード」をご参照ください。

3. AliyunPlayerとAlivcArtcのバージョンが同じかどうかを確認します。 AliyunPlayerとAlivcArtcには同じバージョンを使用する必要があります。

4. 統合後、RTS SDKを手動で読み込む必要があります。

   load RtsSDK:System.loadLibrary("RtsSDK");

5. オプション： エラーが解決しない場合は、AndroidManifest.xmlファイルでandroid:extractNativeLibs="true" を設定し、app/build.gradleファイルでandroid{} を設定します。 サンプルコード：

   packagingOptions {
       jniLibs {
       useLegacyPackaging true
       }
   }

次のサンプルコードは、デフォルトの解像度を設定する方法の例を示しています。

// Video playback based on VidSts is used in this example.
VidSts vidSts = new VidSts();
// For information about the code used for setting parameters such as vid, AccessKeyId, AccessKeySecret, and token, see the documentation about creating an ApsaraVideo player. 
/*
    Parameter 1: The resolution in which you want to play videos. Valid values: FD, LD, SD, HD, 2K, 4K, and OD. 
    Parameter 2: Specifies whether to forcibly use the specified resolution to play videos. false: ApsaraVideo Player SDK uses the first resolution that is available in the preceding order for video playback. true: ApsaraVideo Player SDK forcibly uses the specified resolution to play videos. If a video in the specified resolution is not available, the video is not played. 
*/
vidSts.setQuality("",false);