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

現象：Xcode 14 のビルドを App Store に提出する際に、ビットコード関連のエラーが発生します。

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

解決策：xcrun bitcode_strip コマンドを実行して、フレームワークからビットコードを削除してください。${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 に提出すると、Xcode でのアプリ配布時に [警告ありで配布完了] ダイアログボックスが表示され、アプリが AliyunMediaDownloader.framework/AliyunMediaDownloader 内の非公開セレクター onCompletion: を参照しているという [App Store Connect 操作エラー] が発生します。

症状: Xcode 14 ビルドを App Store に送信すると、フレーム補間およびシャープ化用の後処理プラグイン (mpf_filter.framework、vfi_filter.framework) に関連するエラーが発生します。 Xcode でアプリを配布すると、Payload/xxx.app/Frameworks/mpf_filter.framework の CFBundleIdentifier com.alibaba.AliyunPlayer.mpf_filter と vfi_filter.framework の CFBundleIdentifier com.alibaba.AliyunPlayer.vfi_filter に無効な文字 (アンダースコア) が含まれていることを示す 2 つの Asset validation failed エラーが原因で、[Distribution failed with errors] エラーが発生します。 CFBundleIdentifier には、英数字、ドット (.)、ハイフン (-) のみを含めることができます。

解決策：

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

• プロジェクトでエラーに記載されているプラグインを使用する必要がある場合は、フレームワークパス配下の "Bundle identifier" ファイルにある Info.plist キーの値の文字列から、一時的に "_" を削除し、プロジェクトをコンパイルしてビルドできます。

• 命名が修正されたバージョン 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：プレーヤーの準備が完了 (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];

解決策：正確なシークの最大間隔を増やして、不正確なシークへのフォールバックを減らしてください。間隔を大きくすると精度は向上しますが、キーフレーム間隔が大きい場合はシーク時間が増加する可能性があります：

// 単位: 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 を使用してアダプティブビットレートスイッチングを有効にすると、SDK はネットワーク速度を監視します。速度が 10 秒以内に次のビットレートレベルに達すると、プレーヤーは切り替わります。それ以外の場合は、現在のビットレートのままになります。

• 高ビットレートから低ビットレート：キャッシュされた高ビットレートコンテンツの再生が完了した後、プレーヤーは切り替えます。

• 低ビットレートから高ビットレート：プレーヤーは直ちに切り替えます。

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

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

また、SDK 側でカスタム AVAudioSession プロキシを設定して、SDK 内部の AVAudioSession ロジックをバイパスし、横取りを防ぐこともできます：

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

   [AliPlayer setAudioSessionDelegate:self];

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

   return YES は、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 にアップグレードしてください。最新の SDK では、安定性が継続的に向上しています。最新の 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(@"画面回転エラー:%@", [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(@"画面回転エラー:%@", 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

ApsaraVideo Player SDK V5.4.5.0 未満は、リストプレーヤー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：指定の画質で動画を強制的に再生します。指定の画質が見つからない場合、動画は再生されません。