ApsaraVideo VOD:iOS Player FAQ

Sintoma: Um erro relacionado a bitcode ocorre ao enviar uma build do Xcode 14 para a App Store:

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

Solução: Execute o comando xcrun bitcode_strip para remover o bitcode do framework. ${framework_path} é o caminho do binário do framework.

xcrun bitcode_strip ${framework_path} -r -o ${framework_path}

Sintoma: Um erro relacionado a cURL ocorre ao enviar uma build do Xcode 14 para a App Store:

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/

Solução:

• Caso seu projeto integre apenas o ApsaraVideo Player SDK (AliPlayerSDK_iOS), atualize o SDK para uma versão posterior à 5.4.9.2.

• Se o projeto integrar tanto o ApsaraVideo Player SDK (AliPlayerPartSDK_iOS) quanto o SDK de vídeo curto, atualize o ApsaraVideo Player SDK para uma versão posterior à 5.4.9.2, o alivcffmpeg (QuCore-ThirdParty) para a versão 4.3.6 e o SDK de vídeo curto para uma versão posterior à 3,26.

Sintoma: Um erro sobre APIs não públicas ocorre ao enviar uma build do Xcode 14 para a App Store. Ao distribuir um aplicativo com o Xcode, uma caixa de diálogo Distribution completed with warnings aparece, indicando um App Store Connect Operation Error. O erro informa que o aplicativo referencia um seletor não público onCompletion: em AliyunMediaDownloader.framework/AliyunMediaDownloader.

Sintoma: Um erro relacionado a plugins de pós-processamento (mpf_filter.framework, vfi_filter.framework) para interpolação de quadros e nitidez ocorre ao enviar uma build do Xcode 14 para a App Store. Ao distribuir um aplicativo com o Xcode, ocorre um erro Distribution failed with errors, indicando dois erros de validação de ativo (Asset validation failed): o CFBundleIdentifier com.alibaba.AliyunPlayer.mpf_filter de Payload/xxx.app/Frameworks/mpf_filter.framework e o CFBundleIdentifier com.alibaba.AliyunPlayer.vfi_filter de vfi_filter.framework contêm caracteres inválidos (underscores). Os CFBundleIdentifiers podem conter apenas caracteres alfanuméricos, pontos (.) e hifens (-).

Solução:

• Se o seu projeto não utilizar o plugin mencionado na mensagem de erro, exclua-o. Isso não afeta os recursos do player e reduz o tamanho do pacote.

• Caso seja obrigatório usar o plugin citado no erro, remova temporariamente o "_" da string de valor no par chave-valor "Bundle identifier" no arquivo Info.plist localizado no caminho do framework e, em seguida, compile e construa o projeto.

• Atualize para a versão 5.5.2.0 ou superior, onde a nomenclatura foi corrigida.

O que fazer se o erro "Xcode Error: PhaseScriptExecution failed with a nonzero exit code" ocorrer ao compilar e executar a demo para iOS?

Siga estas etapas: 1. Acesse o diretório do projeto. 2. Execute pod deintegrate.

1. Execute pod install.

Por padrão, o ApsaraVideo Player SDK relata o progresso da reprodução a cada 500 ms. Reduza o intervalo para obter atualizações mais frequentes:

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

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

Três métodos estão disponíveis:

• Método 1: Após o preparo do player (AVPEventPrepareDone), leia a largura e a altura da instância AliPlayer.

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

• Método 2: Escute o callback de alteração de tamanho do vídeo, que retorna a largura e a altura diretamente.

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

• Método 3: Escute o callback de informações de faixa e leia videoWidth e videoHeight do AVPTrackInfo no array info.

  Nota

  Este método depende de uma solicitação de rede. Use o Método 1 ou o Método 2 para maior confiabilidade.

  - (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);
    }
  }

Exemplo:

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

Solução: Aumente o intervalo máximo para busca precisa a fim de reduzir o retorno à busca imprecisa. Um intervalo maior melhora a precisão, mas pode aumentar o tempo de busca quando os quadros-chave estiverem distantes:

// Unit: ms.
[self.player setMaxAccurateSeekDelta:10000];

O código a seguir fornece um exemplo de como obter dados de origem de áudio e vídeo:

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

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

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

    }
    return NO;
}

player.renderingDelegate = self;

#pragma mark CicadaRenderingDelegate
- (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo{
    if(frameInfo.frameType==Cicada_FrameType_Video){
        // Video
        NSLog(@"receive HW frame:%p pts:%ld foramt %d", frameInfo.video_pixelBuffer, frameInfo.pts, CVPixelBufferGetPixelFormatType(frameInfo.video_pixelBuffer));

    } else if (frameInfo.frameType==Cicada_FrameType_Audio){
        // Audio
    }
    return NO;
}

Após ativar a troca adaptativa de taxa de bits com a API [self.player selectTrack:SELECT_AVPTRACK_TYPE_VIDEO_AUTO];, o SDK monitora a velocidade da rede. Se a velocidade atingir o próximo nível de taxa de bits dentro de 10 segundos, o player fará a troca; caso contrário, permanecerá na taxa de bits atual.

• De alta para baixa: o player realiza a troca após o término da reprodução do conteúdo em cache de alta taxa de bits.

• De baixa para alta: a troca pelo player é imediata.

Para personalizar a lógica de nova tentativa, defina a contagem de tentativas como 0 e trate os eventos externamente:

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

/**
 @brief: The callback for player events.
 @param player: The player pointer.
 @param eventWithString: The player event type.
 @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) { // Network error. A retry is required.
        // TODO: Add the processing logic.
    }
}

Solução: Configure o AVAudioSession de maneira unificada em um local apropriado do seu projeto. Por exemplo, configure a sessão de áudio do aplicativo como categoria de reprodução e permita a mixagem com outros aplicativos. Também é possível configurar a sessão de áudio como categoria PlayAndRecord para cenários de gravação e reprodução. Se ocorrer um erro durante a operação, a mensagem será armazenada na variável err.

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

Defina também um proxy personalizado de AVAudioSession no lado do SDK para ignorar sua lógica interna de AVAudioSession e evitar a preempção:

1. Defina o proxy.

   [AliPlayer setAudioSessionDelegate:self];

2. Configure o listener para o proxy.

   return TRUE indica que o SDK não configurará mais o AVAudioSession internamente.

   #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;
   }

Se uma falha de pilha apontando para o SDK ocorrer enquanto você usa o ApsaraVideo Player SDK for iOS, siga estas etapas:

1. Atualize para a versão mais recente do ApsaraVideo Player SDK for iOS, que inclui melhorias contínuas de estabilidade. Baixe o SDK mais recente em Introdução ao SDK.

2. Se a falha persistir após a atualização, forneça informações completas sobre o erro ao suporte técnico da Alibaba Cloud. Obter suporte técnico.

Para identificar a causa:

1. Verifique se a falha ocorre no ApsaraVideo Player SDK.

   Confira se a pilha de falha contém o prefixo AliyunPlayer. Em caso afirmativo, o problema reside no ApsaraVideo Player SDK.

2. Atualize para a versão mais recente do ApsaraVideo Player SDK e verifique se o problema foi resolvido.

3. Caso o problema persista, prepare os arquivos de falha (todas as threads), logs de falha e cenários de falha conforme descrito em Como obter logs.

O código a seguir fornece um exemplo de como implementar este recurso:

UIInterfaceOrientation orientation = UIInterfaceOrientationLandscapeLeft; // Rotate to full screen
......

// For iOS 16.0 and 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(@"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 { // For systems earlier than 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];
}

Para identificar a causa:

1. Verifique se a própria fonte de vídeo possui barras pretas.

2. Chame a seguinte API para ajustar o modo de dimensionamento do player.

   /*
   AVP_SCALINGMODE_SCALEASPECTFILL: The video is scaled to fill the screen. The video may be cropped.
   AVP_SCALINGMODE_SCALEASPECTFIT: The video is scaled to fit the screen. Black bars may appear.
   AVP_SCALINGMODE_SCALETOFILL: The video is scaled to fill the screen without preserving the aspect ratio. The video may be distorted.
   */
   self.player.scalingMode = AVP_SCALINGMODE_SCALETOFILL;

3. Se o modo de dimensionamento não atender aos seus requisitos, ajuste a largura e a altura da visualização personalizada para self.player.playerView modificando o frame de self.player.playerView.

Para identificar a causa:

1. Use outro player para reproduzir o vídeo e verifique se é um arquivo apenas de áudio.

2. Se o vídeo for reproduzido normalmente em outro player e as dimensões do vídeo mudarem, alterne para decodificação por software. O código a seguir mostra como fazer essa alteração:

   player.enableHardwareDecoder = NO

Solução: Remova UIApplicationStateActive == [[UIApplication sharedApplication] applicationState].

- (AliPlayer *)aliPlayer{
    if (!_aliPlayer && UIApplicationStateActive == [[UIApplication sharedApplication] applicationState]) {
        _aliPlayer = [[AliPlayer alloc] init];
        _aliPlayer.scalingMode =  AVP_SCALINGMODE_SCALEASPECTFIT;
        _aliPlayer.rate = 1;
        _aliPlayer.delegate = self;
        _aliPlayer.playerView = self.playerView;
    }
    return _aliPlayer;
}

Versões do ApsaraVideo Player SDK anteriores à V5.4.5.0 não suportam o uso do player de lista AliListPlayer para reproduzir vídeos HLS (m3u8). As versões V5.4.5.0 e posteriores suportam a reprodução de vídeos HLS (m3u8), mas exigem a ativação do cache local. Cache local.

Impossibilidade de reproduzir um vídeo em segundo plano

Sintoma: O ApsaraVideo Player SDK for iOS não suporta reprodução em segundo plano por padrão. A demo também não reproduz vídeos em segundo plano.

Exemplo:

// The following code provides an example of playback using VidSts.
AVPVidStsSource *stsSource = [[AVPVidStsSource alloc] init];
stsSource.vid = @"<vid>";
stsSource.accessKeyId = @"<accessKeyId>";
stsSource.securityToken = @"<securityToken>";
stsSource.accessKeySecret = @"<accessKeySecret>";
stsSource.quality = @""; // The expected definition for playback. Valid values: FD, LD, SD, HD, 2K, 4K, and OD.
stsSource.forceQuality = NO; // Specifies whether to forcibly play the video in the expected definition. NO: The video is not forcibly played in the expected definition. The player searches for definitions in the default order and plays the video in the first definition that it finds. YES: The video is forcibly played in the expected definition. If the expected definition is not found, the video is not played.