Saiba como configurar o Streaming Media Analytics para dispositivos iOS.
Com o fim do suporte para SDKs móveis da versão 4 em 31 de agosto de 2021, a Adobe também encerrará o suporte para o SDK do Media Analytics para iOS e Android. Para obter mais informações, consulte Perguntas frequentes sobre o fim do suporte do SDK do Media Analytics.
Obter parâmetros de configuração válidos para o SDK do Media Esses parâmetros podem ser obtidos de um representante da Adobe após a configuração da sua conta do Analytics.
Implementar o ADBMobile para iOS no aplicativo
Para obter mais informações sobre a documentação do SDK do Adobe Mobile, consulte SDK do iOS 4.x para Soluções da Experience Cloud.
A partir do iOS 9, a Apple introduziu um recurso chamado App Transport Security (ATS). Esse recurso tem como objetivo melhorar a segurança da rede, garantindo que seus aplicativos usem somente protocolos e cifras padrão do setor. Esse recurso é ativado por padrão, mas você tem opções de configuração que fornecem opções para trabalhar com ATS. Para obter detalhes sobre ATS, consulte App Transport Security.
Forneça os seguintes recursos no player de mídia:
A partir da versão 2.3.0, o SDK é distribuído via XCFrameworks.
A versão 2.3.0 do SDK exige o Xcode 12.0 ou mais recente e, se aplicável, o Cocoapods 1.10.0 ou mais recente.
Adicione a biblioteca baixada do SDK do Media ao projeto.
Verifique se os componentes de software a seguir existem no diretório libs
:
ADBMediaHeartbeat.h
: o arquivo do cabeçalho Objective-C usado para APIs de rastreamento de heartbeat no iOS.
ADBMediaHeartbeatConfig.h
: o arquivo do cabeçalho Objective-C usado na configuração do SDK.
MediaSDK.a
: um binário multiarquitetura habilitado para código de bits que contém as compilações de biblioteca para dispositivos iOS (armv7, armv7s, arm64) e simuladores (i386 e x86_64).
Esse binário deve ser vinculado quando o destino for um aplicativo iOS.
MediaSDK_TV.a
: um binário multiarquitetura habilitado para código de bits, que apresente as compilações de biblioteca para novos dispositivos Apple TV (arm64) e simuladores (x86_64).
Esse binário deve ser vinculado quando o destino for pretendido para um aplicativo da Apple TV (tvOS).
Adicione a biblioteca ao projeto:
Abra o Xcode IDE e o seu aplicativo.
No Navegador do projeto, arraste o diretório libs
e solte-o no seu projeto.
Certifique-se de que as caixas de seleção Copiar itens se necessário e Criar grupos estejam marcadas e que nenhuma das caixas de seleção em Adicionar ao destino estejam selecionadas.
Clique em Concluir.
No Navegador do projeto, selecione o seu aplicativo e os seus destinos.
Vincule as estruturas e bibliotecas necessárias na seção Estruturas vinculadas e Bibliotecas na guia Geral.
Destinos de aplicativos iOS:
Públicos da Apple TV (tvOS):
Verifique se o aplicativo foi criado sem erros.
Importe a biblioteca.
#import "ADBMediaHeartbeat.h"
#import "ADBMediaHeartbeatConfig.h"
Crie uma instância ADBMediaHeartbeatConfig
.
Essa seção ajuda você a entender os parâmetros de configuração do MediaHeartbeat
e definir corretamente os valores de configuração na sua instância MediaHeartbeat
, de modo a permitir um rastreamento preciso.
Aqui está uma amostra de inicialização ADBMediaHeartbeatConfig
:
// Media Heartbeat Initialization
ADBMediaHeartbeatConfig *config = [[ADBMediaHeartbeatConfig alloc] init];
config.trackingServer = <SAMPLE_HEARTBEAT_TRACKING_SERVER>;
config.channel = <SAMPLE_HEARTBEAT_CHANNEL>;
config.appVersion = <SAMPLE_HEARTBEAT_SDK_VERSION>;
config.ovp = <SAMPLE_HEARTBEAT_OVP_NAME>;
config.playerName = <SAMPLE_PLAYER_NAME>;
config.ssl = <YES/NO>;
config.debugLogging = <YES/NO>;
Implemente o protocolo ADBMediaHeartbeatDelegate
.
@interface VideoAnalyticsProvider : NSObject <ADBMediaHeartbeatDelegate>
@end
@implementation VideoAnalyticsProvider
// Replace <bitrate>, <startuptime>, <fps> and <droppeFrames>
// with the current playback QoS values.
- (ADBMediaObject *)getQoSObject {
return [ADBMediaHeartbeat createQoSObjectWithBitrate:<bitrate>
startupTime:<startuptime>
fps:<fps>
droppedFrames:<droppedFrames>];
}
// Return the current video player playhead position.
// Replace <currentPlaybackTime> with the video player current playback time
- (NSTimeInterval)getCurrentPlaybackTime {
return <currentPlaybackTime>;
}
@end
Use ADBMediaHeartBeatConfig
e ADBMediaHeartBeatDelegate
para criar a instância ADBMediaHeartbeat
.
//Replace <ADBMediaHeartBeatDelegate> with your delegate instance
_mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate:
<ADBMediaHeartBeatDelegate> config:config];
Certifique-se de que a instância ADBMediaHeartbeat
possa ser acessada e não seja desalocada até o final da sessão. Essa instância será usada para todos os eventos de rastreamento a seguir.
Na versão 2.x, todos os métodos públicos foram consolidados na classe ADBMediaHeartbeat
para facilitar o trabalho dos desenvolvedores. Todas as configurações foram consolidadas na classe ADBMediaHeartbeatConfig
.
Para obter informações sobre a migração da versão 1.x para a 2.x, consulte a documentação da Implementação herdada.)
Com o lançamento da nova Apple TV, agora é possível criar aplicativos para execução no ambiente tvOS nativo. Você pode criar um aplicativo puramente nativo, usando qualquer uma das várias estruturas disponíveis no iOS, ou criar seu aplicativo usando modelos XML e JavaScript. A partir da versão 2.0 do SDK do Media, o suporte para tvOS está disponível. Para mais informações sobre tvOS, consulte o Site do desenvolvedor do tvOS.
Execute as seguintes etapas no projeto Xcode. Este guia foi escrito supondo que seu projeto tem um público-alvo que é um aplicativo da Apple TV direcionado ao tvOS:
Arraste o arquivo de biblioteca VideoHeartbeat_TV.a
para a pasta lib
do seu projeto.
Na guia Criar fases do destino do seu aplicativo tvOS, expanda a seção Link binário com bibliotecas e adicione as seguintes bibliotecas:
MediaSDK_TV.a
AdobeMobileLibrary_TV.a
libsqlite3.0.tbd
SystemConfiguration.framework