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

問題の説明: 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 for iOSのみをプロジェクトに統合する場合は、SDKをV5.4.9.2以降に更新することを推奨します。

• ApsaraVideo Player SDK for iOSとショートビデオSDKをプロジェクトに統合する場合、ApsaraVideo Player SDKをV5.4.9.2以降に、AlivcFFmpeg (QuCore-ThirdParty) をV4.3.6に、ショートビデオSDKをV3.26以降に更新することを推奨します。

問題の説明: Xcode 14を使用してアプリをパッケージ化してapp Storeに送信すると、レビュー中に非公開セレクターに関連するエラーが返されます。 次の図は、サンプルエラーを示しています。

問題の説明: アプリがパッケージ化され、Xcode 14を使用してapp Storeに送信された後、フレーム挿入用のmpf_filter.frameworkと画像鮮鋭化後の後処理用のvfi_filter.frameworkに関する次のエラーが返されます。

解決策：

• エラーメッセージに記載されているプラグインを使用する必要がない場合は、プロジェクトからプラグインを削除することをお勧めします。 これにより、パッケージのサイズが小さくなり、プレーヤーのパフォーマンスが損なわれることはありません。

• プロジェクトがこれらのプラグインに依存している場合は、Info.plistファイルの "Bundle identifier" キーと値のペアの値から "_" を削除します。 このファイルは、フレームワークが格納されているディレクトリにあります。 次に、プロジェクトを再コンパイルしてビルドします。

• ApsaraVideo Player SDKをV5.5.2.0以降に更新します。 ApsaraVideo Player SDK V5.5.2.0以降で、プラグイン名に関連する問題が修正されました。

解決策: プロジェクト内のすべてのオーディオプレーヤーのAVAudioSessionを同じ値に設定します。 たとえば、アプリケーションのオーディオセッションを再生モードに設定し、他のアプリケーションとのオーディオミキシングを許可します。 ビデオの録画と再生を同時に行う場合は、アプリケーションのオーディオセッションをPlayAndRecordに設定することもできます。 操作の実行時にエラーが発生した場合、エラーメッセージはerr変数に格納されます。

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

次に、ApsaraVideo Player SDK for iOSで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を指すスタックがクラッシュした場合、次のいずれかの方法を使用して問題を解決できます。

1. ApsaraVideo Player SDK for iOSを最新バージョンに更新します。 ApsaraVideo Player SDK for iOSは、安定性を向上させるために更新を続けています。 ApsaraVideo Player SDKの最新バージョンを入手する方法の詳細については、「SDKの概要とダウンロード」をご参照ください。

2. SDKを最新バージョンに更新しても問題が解決しない場合は、トラブルシューティングのためにすべてのクラッシュ情報をAlibaba Cloudテクニカルサポートに提供することを推奨します。 テクニカルサポートへの連絡方法の詳細については、「テクニカルサポートへの連絡」をご参照ください。

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

AVPConfig *config = [self.player getConfig];
config.positionTimerIntervalMs = 100; // Change the callback interval. Unit: milliseconds. 
[self.player setConfig:config];

/**
 @brief: The callback for the current playback position. 
 @param player: The pointer for the player. 
 @param position: The current playback position. 
 */
- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    // The current playback position. 
    long currentPosition = position;
}

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

• 方法1: AliPlayerインスタンスでprepareメソッドを呼び出します。 AVPEventPrepareDoneイベントが完了したら、AliPlayerインスタンスの高さと幅を取得します。

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

• 方法2: ビデオサイズが変更されたときにトリガーされるイベントをリッスンします。

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

• 方法3: トラック情報を取得するためのコールバックを設定します。 返された配列のAVPTrackInfoからビデオの幅と高さを取得できます。

  説明

  この方法は、データを取得するためにインターネットを介して要求が送信されるため、ネットワーク品質に大きく依存します。 ビデオの幅と高さを取得するには、方法1または方法2を使用することを推奨します。

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

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

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

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

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

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

サンプルコード：

UIInterfaceOrientation orientation = UIInterfaceOrientationLandscapeLeft; // Rotate the view to enable full-screen playback.
......

// The following sample code applies to iOS 16.0 or later.
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(@"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(@"Rotation error:%@", exception.reason);
  } @finally {
  }
} else { // The following sample code applies to iOS versions earlier than 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. 次の操作を呼び出して、プレーヤーのスケーリングモードを変更します。

   /*
   AVP_SCALINGMODE_SCALEASPECTFILL: crops the video to fit the view based on the aspect ratio of the video. 
   AVP_SCALINGMODE_SCALEASPECTFIT: scales in the video based on the aspect ratio of the video. Black bars are displayed in the view. 
   AVP_SCALINGMODE_SCALETOFILL: stretches the video to fill in the view. Image distortion may occur. 
   */
   self.player.scalingMode = AVP_SCALINGMODE_SCALETOFILL;

3. スケーリングモードを変更しても問題が解決しない場合は、self.player.playerViewを呼び出し、frameパラメーターを指定してビューの幅と高さをカスタマイズします。

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

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

2. ビデオを別のプレーヤーで再生でき、ビデオのアスペクト比がビデオソースのアスペクト比と異なる場合は、ソフトウェアデコードを使用します。

   player.enableHardwareDecoder = NO

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

解決策：

1. Xcodeでバックグラウンドデータ収集機能を有効にします。 次の図は例を示しています。

2. フォアグラウンドイベントとバックグラウンドイベントをリッスンするメソッドを指定した場合は、一時停止メソッドと開始メソッドをコメントアウトします。

   // Add a method to listen to the event that the app enters the background.
   [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationEnterBackground) name: UIApplicationWillResignActiveNotification object:nil];
   // Call this method when the app is switched to the foreground from the background.
   [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationDidBecomeActive) name: UIApplicationDidBecomeActiveNotification object:nil];
   
   // Comment out the pause method.
   - (void)applicationEnterBackground {
      // [self.player pause];
   }
   // Comment out the start method.
   - (void)applicationDidBecomeActive {
      // [self.player start];
   }

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

// Switch to the inaccurate seeking mode. 
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_INACCURATE];
// Switch to the accurate seeking mode. 
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_ACCURATE];

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

// Unit: milliseconds. 
[self.player setMaxAccurateSeekDelta:100];

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

/**
 @brief: The callback for player events. 
 @param player: The pointer for the player. 
 @param eventWithString: The type of the player event. 
 @param description: The description of the player event. 
 @see AVPEventType
 */
-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
    if (eventWithString == EVENT_PLAYER_CACHE_SUCCESS) { // Caching during playback succeeded. 

    } else if (eventWithString == EVENT_PLAYER_CACHE_ERROR) { // Caching during playback failed. 
        NSString *errorMsg = description;
    }
}

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

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

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

次のサンプルコードは、メディアソースデータを取得する方法の例を示しています。

// Configure the rendering callback. 
self.player.renderingDelegate = self;

// Listen to the rendering callback. 
- (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo {
    if (frameInfo.frameType == Cicada_FrameType_Video) { // The underlying video data. 

    } else if (frameInfo.frameType == Cicada_FrameType_Audio) { // The underlying audio data. 

    }
    return NO;
}

[self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO] を呼び出して自動ビットレート切り替え機能を有効にすると、ApsaraVideo Player SDKはネットワーク速度を監視します。 ビデオのビットレートは、10秒の平均ネットワーク速度に基づいて、より高いビットレートとより低いビットレートとの間で切り替えられる。 10秒の平均ネットワーク速度が条件を満たさない場合、ビデオビットレートは切り替えられません。

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

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

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

AVPConfig *config = [self.player getConfig];
config.networkRetryCount = 0; // The number of retries. In this example, this parameter is set to 0. 
[self.player setConfig:config];

/**
 @brief: The callback for player events. 
 @param player: The pointer for the player. 
 @param eventWithString: The type of the player event. 
 @param description: The description of the player event. 
 @see AVPEventType
 */
-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
    if (eventWithString == EVENT_PLAYER_NETWORK_RETRY) { // The network connection fails. Try again. 
        // Configure the retry logic. 
    }
}

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

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

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

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

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

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

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

// Video playback based on VidSts is used in this example. 
AVPVidStsSource *stsSource = [[AVPVidStsSource alloc] init];
stsSource.vid = @"<vid>";
stsSource.accessKeyId = @"<accessKeyId>";
stsSource.securityToken = @"<securityToken>";
stsSource.accessKeySecret = @"<accessKeySecret>";
stsSource.quality = @""; // The resolution in which you want to play videos. Valid values: FD, LD, SD, HD, 2K, 4K, and OD. 
stsSource.forceQuality = NO; // Specifies whether to forcibly use the specified resolution to play videos. NO: ApsaraVideo Player SDK uses the first resolution that is available in the preceding order for video playback. Yes: 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.