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` コマンドを実行して、framework から手動で bitcode を削除できます。次の例では、${framework_path} は framework のバイナリファイルのパスです。

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 などの後処理プラグイン関連のエラーが発生します。次の図はエラーメッセージの例です。

ソリューション：

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

• プロジェクトがエラーで言及されているプラグインを使用する必要がある場合は、一時的に 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 の frame を変更することで、self.player.playerView 用のカスタムビューの幅と高さを調整できます。

次の手順に従って問題の原因を特定できます。

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：期待される解像度で動画を強制的に再生します。期待される解像度が見つからない場合、動画は再生されません。