ApsaraVideo VOD: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 でアプリを配布する際に、[Distribution completed with warnings] ダイアログボックスが表示され、[App Store Connect Operation Error] が示されます。このエラーは、アプリが AliyunMediaDownloader.framework/AliyunMediaDownloader 内の非公開セレクター onCompletion: を参照していることを示します。

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

解決策：

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

• プロジェクトがエラーで言及されているプラグインを使用する必要がある場合は、フレームワークパスの下にある 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：プレーヤーの準備が完了した後 (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 プロキシを設定して、内部の AVAudioSession ロジックをバイパスし、横取りを防ぐこともできます。

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 にアップグレードしてください。これには継続的な安定性の改善が含まれています。最新の 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. スケーリングモードが要件を満たさない場合は、frame of self.player.playerView を変更することで、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: 期待される解像度でビデオを強制的に再生します。期待される解像度が見つからない場合、ビデオは再生されません。