ApsaraVideo VOD:ApsaraVideo Player SDK for iOS に関するよくある質問

現象：Xcode 14 でアプリをパッケージ化し、App Store にレビュー申請する際に、Bitcode 関連のエラーが発生します。以下にエラーメッセージの例を示します。

 ITMS-90482: Invalid Executable - The executable 'xxx.app/Frameworks/alivcffmpeg.framework/alivcffmpeg' contains bitcode.

解決策：`xcrun bitcode_strip` コマンドを実行して、フレームワークから手動で Bitcode を削除できます。以下の例では、`${framework_path}` はフレームワークのバイナリファイルのパスです。

xcrun bitcode_strip ${framework_path} -r -o ${framework_path}

現象：Xcode 14 でアプリをパッケージ化し、App Store にレビュー申請する際に、cURL 関連のエラーが発生します。以下にエラーメッセージの例を示します。

ITMS-90338: Non-public API usage - The app references non-public symbols in Frameworks/AliyunPlayer.framework/AliyunPlayer: _curl_multi_poll, _curl_multi_wakeup. If method names in your source code match the private Apple APIs listed above, altering your method names will help prevent this app from being flagged in future submissions. In addition, note that one or more of the above APIs may be located in a static library that was included with your app. If so, they must be removed. For further information, visit the Technical Support Information at http://developer.apple.com/support/technical/

解決策：

• プロジェクトに ApsaraVideo Player SDK (AliPlayerSDK_iOS) のみを統合している場合は、SDK を 5.4.9.2 以降のバージョンにアップグレードしてください。

• プロジェクトに ApsaraVideo Player SDK (AliPlayerPartSDK_iOS) とショートビデオ SDK の両方を統合している場合は、ApsaraVideo Player SDK を 5.4.9.2 以降のバージョンに、alivcffmpeg (QuCore-ThirdParty) をバージョン 4.3.6 に、ショートビデオ SDK を 3.26 以降のバージョンにアップグレードしてください。

現象：Xcode 14 でアプリをパッケージ化し、App Store にレビュー申請する際に、非公開 API に関するエラーが発生します。以下の図にエラーメッセージの例を示します。

現象：Xcode 14 でアプリをパッケージ化し、App Store にレビュー申請する際に、フレーム補間やシャープ化のための mpf_filter.framework や vfi_filter.framework などの後処理プラグインに関するエラーが発生します。以下の図にエラーメッセージの例を示します。

解決策：

• プロジェクトがエラーメッセージで言及されているプラグインを使用していない場合は、そのプラグインを削除できます。これにより、プレーヤーの機能に影響を与えることなく、パッケージサイズを削減できます。

• プロジェクトがエラーメッセージで言及されているプラグインを使用する必要がある場合は、一時的にフレームワークパス配下の Info.plist ファイル内の "Bundle identifier" キーと値のペアの値の文字列から "_" を削除してから、プロジェクトをコンパイルおよびビルドしてください。

• バージョン 5.5.2.0 以降にアップグレードすることで、命名が修正されています。

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

AVPConfig *config = [self.player getConfig];
config.positionTimerIntervalMs = 100; // コールバック間隔を変更します。単位：ms
[self.player setConfig:config];

/**
 @brief: 現在の再生位置のコールバック
 @param player: プレーヤーポインター
 @param position: 現在の再生位置
 */
- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    // 現在の再生進捗
    long currentPosition = position;
}

以下の 3 つの方法のいずれかを使用できます。

• 方法 1：iOS 用の AliPlayer インスタンスに対して prepare メソッドが呼び出され、プレーヤーの準備が完了した後 (AVPEventPrepareDone)、AliPlayer インスタンスの幅と高さを直接取得できます。

  -(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
      if (eventType == AVPEventPrepareDone) {
        NSLog(@"Video width: %d, height: %d", player.width, player.height);
      }
  }

• 方法 2：動画サイズが変更されたときに返されるコールバックをリッスンします。このコールバックは、動画の幅と高さを直接返します。

  - (void)onVideoSizeChanged:(AliPlayer*)player width:(int)width height:(int)height rotation:(int)rotation {
      NSLog(@"Video width: %d, height: %d", width, height);
  }

• 方法 3：トラック情報が取得されたときに返されるコールバックをリッスンします。info 配列で返される AVPTrackInfo から videoWidth と videoHeight を取得します。

  説明

  トラック情報のコールバックをリッスンするには、ネットワークリクエストが必要です。動画の幅と高さの取得が成功するかどうかは、ネットワーク品質に依存します。より高い信頼性を得るには、方法 1 または方法 2 を使用して動画の幅と高さを取得してください。

  - (void)onTrackReady:(AliPlayer*)player info:(NSArray<AVPTrackInfo*>*)info {
      for (int i=0; i<info.count; i++) {
        AVPTrackInfo *trackInfo = info[i];
        NSLog(@"Video width: %d, height: %d", trackInfo.videoWidth, trackInfo.videoHeight);
    }
  }

以下に、シークモードを切り替えるコード例を示します。

// 不正確なシークに切り替える
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_INACCURATE];
// 正確なシークに切り替える
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_ACCURATE];

解決策：API を呼び出して、正確なシークの最大間隔をより大きく設定できます。これにより、プレーヤーが正確なシークから不正確なシークに切り替わる頻度が減り、シークの精度が向上します。ただし、シークポイントから最も近いキーフレームまでの距離が大きすぎると、シーク操作に時間がかかります。必要に応じて、正確なシークの最大間隔を設定してください。以下にコード例を示します。

// 単位：ms
[self.player setMaxAccurateSeekDelta:10000];

以下に、音声および動画のソースデータを取得する方法のコード例を示します。

// レンダリングコールバックを設定
self.player.renderingDelegate = self;

// レンダリングコールバックをリッスン
- (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo {
    if (frameInfo.frameType == Cicada_FrameType_Video) { // 基礎となる動画データ

    } else if (frameInfo.frameType == Cicada_FrameType_Audio) { // 基礎となる音声データ

    }
    return NO;
}

[self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO]; API を呼び出してアダプティブビットレート切り替えを有効にすると、ApsaraVideo Player SDK は現在のネットワーク速度の統計を収集します。ネットワーク速度が 10 秒以内に次のビットレートレベルに達した場合、プレーヤーはそのビットレートに切り替わります。ネットワーク速度が 10 秒以内に次のビットレートレベルに達しない場合、プレーヤーは切り替えません。

• 高ビットレートから低ビットレートに切り替える場合、ネットワーク速度が 10 秒以内に次のビットレートレベルに達すると、高ビットレートでキャッシュされたコンテンツの再生が終了した後にプレーヤーが切り替わります。

• 低ビットレートから高ビットレートに切り替える場合、ネットワーク速度が 10 秒以内に次のビットレートレベルに達すると、プレーヤーはすぐに切り替わります。

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

AVPConfig *config = [self.player getConfig];
config.networkRetryCount = 0; // リトライ回数を設定します。この例では、値を 0 に設定しています。
[self.player setConfig:config];

/**
 @brief: プレーヤーイベントのコールバック
 @param player: プレーヤーポインター
 @param eventWithString: プレーヤーイベントタイプ
 @param description: プレーヤーイベントの説明
 @see AVPEventType
 */
-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
    if (eventWithString == EVENT_PLAYER_NETWORK_RETRY) { // ネットワークエラー。リトライが必要です。
        // TODO: 処理ロジックを追加します。
    }
}

解決策：プロジェクトの適切な場所で AVAudioSession を統一的に構成できます。たとえば、アプリのオーディオセッションを再生カテゴリとして構成し、他のアプリとのミキシングを許可できます。また、録画および再生シナリオのために、アプリのオーディオセッションを PlayAndRecord カテゴリとして構成することもできます。操作中にエラーが発生した場合、エラーメッセージは err 変数に格納されます。

[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback withOptions:AVAudioSessionCategoryOptionMixWithOthers error:&err];

同時に、ApsaraVideo Player SDK for iOS 側では、AVAudioSession のプロキシをカスタマイズし、SDK 内部で定義された AVAudioSession ロジックを使用しないようにすることができます。これにより、ApsaraVideo Player SDK for iOS が引き起こす可能性のあるオーディオの横取りのリスクを回避できます。以下に、ApsaraVideo Player SDK for iOS 側での構成例を示します。

1. プロキシを設定します。

   [AliPlayer setAudioSessionDelegate:self];

2. プロキシのリスナーを設定します。

   return TRUE は、SDK が内部で AVAudioSession を構成しなくなることを示します。

   #pragma mark CicadaAudioSessionDelegate
   - (BOOL)setActive:(BOOL)active error:(NSError **)outError
   {
       return YES;
   }
   
   - (BOOL)setCategory:(NSString *)category withOptions:(AVAudioSessionCategoryOptions)options error:(NSError **)outError
   {
         return YES;
   }
   
   - (BOOL)setCategory:(AVAudioSessionCategory)category mode:(AVAudioSessionMode)mode routeSharingPolicy:(AVAudioSessionRouteSharingPolicy)policy options:(AVAudioSessionCategoryOptions)options error:(NSError **)outError
   {
       return YES;
   }

ApsaraVideo Player SDK for iOS の使用中に SDK を指すスタッククラッシュが発生した場合は、以下の方法で問題を解決できます。

1. ApsaraVideo Player SDK for iOS の最新バージョンを使用していない場合は、最新バージョンにアップグレードしてください。ApsaraVideo Player SDK for iOS は安定性を向上させるために継続的に更新されています。最新の SDK の入手方法については、「SDK の概要」をご参照ください。

2. 最新バージョンにアップグレードしてもクラッシュが解決しない場合は、完全なクラッシュ情報を Alibaba Cloud のテクニカルサポートに提供してください。テクニカルサポートの入手方法については、「テクニカルサポートの利用」をご参照ください。

以下の手順で問題の原因を特定できます。

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

   クラッシュスタックに AliyunPlayer プレフィックスが含まれているかどうかを確認します。含まれている場合、問題は ApsaraVideo Player SDK で発生しています。

2. ApsaraVideo Player SDK の最新バージョンにアップグレードし、問題が解決したかどうかを確認します。

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

以下に、この機能を実装する方法のコード例を示します。

UIInterfaceOrientation orientation = UIInterfaceOrientationLandscapeLeft; // 全画面に回転
......

// iOS 16.0 以降の場合
if (@available(iOS 16.0, *)) {
    @try {
            NSArray *array = [[[UIApplication sharedApplication] connectedScenes] allObjects];
      UIWindowScene *ws = (UIWindowScene *)array[0];
        Class GeometryPreferences = NSClassFromString(@"UIWindowSceneGeometryPreferencesIOS");
      id geometryPreferences = [[GeometryPreferences alloc]init];
      UIInterfaceOrientationMask orientationMask = UIInterfaceOrientationMaskLandscapeRight;
      if (orientation == UIInterfaceOrientationPortrait) {
          orientationMask = UIInterfaceOrientationMaskPortrait;
      }
      [geometryPreferences setValue:@(orientationMask) forKey:@"interfaceOrientations"];
      SEL sel_method = NSSelectorFromString(@"requestGeometryUpdateWithPreferences:errorHandler:");
      void (^ErrorBlock)(NSError *err) = ^(NSError *err){
            NSLog(@"Screen rotation error:%@", [err debugDescription]);
      };
      if ([ws respondsToSelector:sel_method]) {
          (((void (*)(id, SEL,id,id))[ws methodForSelector:sel_method])(ws, sel_method,geometryPreferences,ErrorBlock));
      }
  } @catch (NSException *exception) {
      NSLog(@"Screen rotation error:%@", exception.reason);
  } @finally {
  }
} else { // iOS 16.0 より前のシステムの場合
  if ([[UIDevice currentDevice] respondsToSelector:@selector(setOrientation:)]) {
      SEL selector = NSSelectorFromString(@"setOrientation:");
      NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:[UIDevice instanceMethodSignatureForSelector:selector]];
      [invocation setSelector:selector];
      [invocation setTarget:[UIDevice currentDevice]];
      [invocation setArgument:&Orientation atIndex:2];
      [invocation invoke];
  }
  [[UIApplication sharedApplication]setStatusBarOrientation:orientation animated:YES];
}

以下の手順で問題の原因を特定できます。

1. 動画ソース自体に黒帯があるかどうかを確認します。

2. 以下の API を呼び出して、プレーヤーのスケーリングモードを調整できます。

   /*
   AVP_SCALINGMODE_SCALEASPECTFILL: 動画は画面いっぱいに拡大されます。動画がクロップされる場合があります。
   AVP_SCALINGMODE_SCALEASPECTFIT: 動画は画面に合わせて拡大されます。黒帯が表示される場合があります。
   AVP_SCALINGMODE_SCALETOFILL: 動画は縦横比を維持せずに画面いっぱいに拡大されます。動画が歪む場合があります。
   */
   self.player.scalingMode = AVP_SCALINGMODE_SCALETOFILL;

3. スケーリングモードが要件を満たさない場合は、self.player.playerView のカスタムビューの幅と高さを、self.player.playerView の frame を変更することで調整できます。

以下の手順で問題の原因を特定できます。

1. 別のプレーヤーで動画を再生し、音声のみのファイルかどうかを確認します。

2. 別のプレーヤーで動画が正常に再生され、動画のディメンションが変更される場合は、ソフトウェアデコードに切り替えることができます。以下に、ソフトウェアデコードに切り替える方法を示します。

   player.enableHardwareDecoder = NO

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

以下にコード例を示します。

// 以下のコードは、VidSts を使用した再生の例です。
AVPVidStsSource *stsSource = [[AVPVidStsSource alloc] init];
stsSource.vid = @"<vid>";
stsSource.accessKeyId = @"<accessKeyId>";
stsSource.securityToken = @"<securityToken>";
stsSource.accessKeySecret = @"<accessKeySecret>";
stsSource.quality = @""; // 再生に期待される解像度。有効な値：FD、LD、SD、HD、2K、4K、OD。
stsSource.forceQuality = NO; // 期待される解像度で動画を強制的に再生するかどうかを指定します。NO：期待される解像度で動画を強制的に再生しません。プレーヤーはデフォルトの順序で解像度を検索し、最初に見つかった解像度で動画を再生します。YES：期待される解像度で動画を強制的に再生します。期待される解像度が見つからない場合、動画は再生されません。