問題現象：使用5.4.7.1及之后版本的播放器時，出現如下報錯。

解決方法：

• 請先確認您是否已申請License授權并在已配置License，5.4.7.1及之后版本播放器SDK需要配置License之后才能正常使用，具體操作，請參見License說明。

  說明

  當您使用組件化、多工程維護的代碼工程，且已根據License說明配置好License后，如果使用AliListPlayer播放，仍然報錯License is invalid!!!，則建議您使用5.5.0.0及以上版本的播放器SDK。

• 請確認您配置的License是否正確，判斷方法請參見如何判斷License是否正確。

問題現象：使用iOS Xcode14打包APP并提交到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}

問題現象：當使用iOS Xcode14打包APP并提交到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/

處理方法：

• 如果您的項目中只集成了播放器SDK（AliPlayerSDK_iOS），則建議您升級到5.4.9.2以上版本。

• 如果您的項目中既集成了播放器SDK（AliPlayerPartSDK_iOS），同時還集成了短視頻SDK，則建議播放器SDK升級到5.4.9.2以上版本，alivcffmpeg（QuCore-ThirdParty）升級到4.3.6版本，短視頻SDK升級到3.26以上版本。

問題現象：當使用iOS Xcode14打包APP并提交到App Store審核時出現非公開方法的錯誤，報錯示例如下：

問題現象：當使用iOS Xcode14打包APP并提交到App Store審核時出現引入mpf_filter.framework、vfi_filter.framework等插幀、銳化后處理插件相關的錯誤，報錯示例如下：

處理方法：

• 如果您的工程中沒有使用到報錯提及的插件，則建議您刪除報錯的插件，不僅不會影響播放器的能力，還可以減小包的體積。

• 如果您的工程中必須使用報錯提及的插件，則可以暫時在該framework路徑下的Info.plist文件中的"Bundle identifier"鍵值對中，將值字符串中的"_"手動去掉，然后再進行編譯構建工程。

• 可升級至5.5.2.0及以上版本，已修正命名。

當您在使用iOS播放器SDK時出現指向SDK的堆棧崩潰，您可以通過如下方法解決：

1. 若您使用的iOS播放器SDK不是最新版本，建議您升級至最新版本。iOS播放器SDK在不斷的推出新版本優化提升穩定性，最新版SDK的獲取，請參見播放器SDK。

2. 如果升級到最新版本后仍然出現相關崩潰，建議您將全量崩潰信息提供給阿里云技術支持。獲取技術支持，請參見獲取技術支持。

播放器SDK默認每500 ms回調一次播放進度。您可以修改回調間隔時間，通過將間隔時間縮短，以更高頻率地獲取當前播放進度，示例代碼如下：

AVPConfig *config = [self.player getConfig];
config.positionTimerIntervalMs = 100; // 修改回調間隔時間，單位：ms。
[self.player setConfig:config];

/**
 @brief：視頻當前播放位置回調。
 @param player：播放器player指針。
 @param position：視頻當前播放位置。
 */
- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    // 當前播放進度。
    long currentPosition = position;
}

可通過如下三種方式進行獲取：

• 方式一：通過iOS播放器AliPlayer實例執行完prepare方法，當處于準備完成狀態后（AVPEventPrepareDone），可以直接獲取AliPlayer實例的寬（width）和高（height）。

  -(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
      if (eventType == AVPEventPrepareDone) {
        NSLog(@"視頻的寬:%d，高:%d", player.width, player.height);
      }
  }

• 方式二：通過監聽視頻大小變化回調的方法，直接返回視頻的寬（width）和高（height）。

  - (void)onVideoSizeChanged:(AliPlayer*)player width:(int)width height:(int)height rotation:(int)rotation {
      NSLog(@"視頻的寬:%d，高:%d", width, height);
  }

• 方式三：通過監聽獲取track信息回調的方法，根據info數組返回的AVPTrackInfo，獲取視頻的寬（videoWidth）和高（videoHeight）。

  說明

  監聽獲取track信息回調，由于是從網絡請求，其成功獲取到視頻的寬高信息依賴網絡質量，建議使用方式一和方式二的方法獲取視頻的寬高信息更為可靠。

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

可通過以下步驟排查問題產生原因：

1. 確認crash是否產生在播放器SDK。

   查看是否有帶AliyunPlayer前綴的崩潰堆棧，如果有，則說明問題產生在播放器SDK。

2. 升級至最新版播放器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 { // iOS16.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：按比例填充，畫面會有裁剪。
   AVP_SCALINGMODE_SCALEASPECTFIT：按比例縮放，會有黑邊。
   AVP_SCALINGMODE_SCALETOFILL：不按比例填充，畫面會變形。
   */
   self.player.scalingMode = AVP_SCALINGMODE_SCALETOFILL;

3. 若縮放模式依然無法滿足需求，則可以調節設置self.player.playerView的自定義View的寬和高（通過修改self.player.playerView的frame實現）。

可通過以下步驟排查問題產生原因：

1. 使用其他播放器播放，檢查視頻是否是純音頻。

2. 使用其他播放器播放時播放正常且出現視頻源長寬變化，則可以設置成軟解碼方式，設置方法如下：

   player.enableHardwareDecoder = NO

V5.4.5.0及之前版本的播放器SDK不支持使用列表播放器AliListPlayer播放HLS（m3u8）格式的視頻。從V5.4.5.0之后版本開始支持播放HLS（m3u8）格式的視頻，但是需要開啟本地緩存，開啟本地緩存的方法請參見本地緩存。

解決方法：

1. 在Xcode中開啟后臺采集數據功能。示例如下：

2. 如果實現了程序前后臺監聽方法，則需要注釋掉相關的暫停、重新播放方法。

   // 添加檢測APP進入后臺的觀察者
   [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationEnterBackground) name: UIApplicationWillResignActiveNotification object:nil];
   // APP從后臺進入前臺時會調用該方法
   [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationDidBecomeActive) name: UIApplicationDidBecomeActiveNotification object:nil];
   
   // 需注釋掉的暫停方法
   - (void)applicationEnterBackground {
      // [self.player pause];
   }
   // 需注釋掉的重新播放方法
   - (void)applicationDidBecomeActive {
      // [self.player start];
   }

切換seek模式的示例代碼如下：

//切換為非精準seek。
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_INACCURATE];
//切換為精準seek。
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_ACCURATE];

解決方法：可以通過接口設置精準seek的最大間隔，將精準seek的最大間隔調大，降低精準seek被切換成非精準seek的頻率，以提高seek精準度，但當seek的點距離關鍵幀間隔太長時，耗時也將更長，請根據業務特點合理設置精準seek的最大間隔。示例代碼如下：

//單位：ms。
[self.player setMaxAccurateSeekDelta:100];

可以在onPlayerEvent回調中，獲取緩存失敗的原因。onPlayerEvent回調的示例代碼如下：

/**
 @brief：播放器事件回調。
 @param player：播放器player指針。
 @param eventWithString：播放器事件類型。
 @param description：播放器事件說明。
 @see AVPEventType
 */
-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
    if (eventWithString == EVENT_PLAYER_CACHE_SUCCESS) { // 邊播邊緩存成功。

    } else if (eventWithString == EVENT_PLAYER_CACHE_ERROR) { // 邊播邊緩存失敗。
        NSString *errorMsg = description;
    }
}

常見的失敗原因如下：

• CacheConfig中設置的大小和時長與視頻不匹配導致緩存失敗。

• 在播放過程中，stop或者seek到buffer外導致緩存失敗。

獲取音視頻源數據的示例代碼如下：

// 設置渲染回調。
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];接口后，播放器SDK內部會統計當前網速，當10秒內網速達到下一個碼率時，就會切換到下一個碼率。若10秒內網速未達到下一個碼率，則不切換。

• 從高碼率切換到低碼率的場景，當10秒內網速達到下一個碼率時，會將已緩存的高碼率內容播放完成后才切換。

• 從低碼率切換到高碼率的場景，當10秒內網速達到下一個碼率時，會直接切換。

可以自定義重試邏輯，當觸發重試時，將重試事件通知到外部，由外部決定具體的重試邏輯。示例代碼如下：

AVPConfig *config = [self.player getConfig];
config.networkRetryCount = 0; // 設置重試次數，此處以設置為0為例。
[self.player setConfig:config];

/**
 @brief：播放器事件回調。
 @param player：播放器player指針。
 @param eventWithString：播放器事件類型。
 @param description：播放器事件說明。
 @see AVPEventType
 */
-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
    if (eventWithString == EVENT_PLAYER_NETWORK_RETRY) { // 網絡失敗，需要重試。
        // TODO做相應的邏輯處理。
    }
}

可通過以下步驟排查報錯原因：

1. 檢查3個SDK（AliPlayerSDK_iOS、AliPlayerSDK_iOS_ARTC、RtsSDK）是否全部都已集成。

   使用阿里云播放器播放RTS流，需要集成3個SDK：AliPlayerSDK_iOS、AliPlayerSDK_iOS_ARTC、RtsSDK。集成操作可參見阿里云播放器SDK集成Native RTS SDK實現說明。

2. 檢查Native RTS SDK（RtsSDK）和阿里云播放器SDK（AliPlayerSDK_iOS）的版本是否配套。

   Native RTS SDK和阿里云播放器SDK有版本配套關系，需要集成對應的版本，版本配套關系請參見SDK下載。

3. 檢查AliPlayerSDK_iOS和AliPlayerSDK_iOS_ARTC的版本是否一致，需保持一致。

示例代碼如下：

//以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：不強制使用期望的清晰度播放，按播放器SDK的默認清晰度播放順序查找播放；YES：強制使用設置的期望清晰度播放，如果找不到期望播放的清晰度就不播放。