Configurar iOS set-up-ios
Saiba como configurar o complemento Coleção de mídia de streaming para dispositivos iOS.
Pré-requisitos
-
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.note important IMPORTANT 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:
- Uma API para assinar eventos do player - O SDK de mídia exige que você chame um conjunto de APIs simples quando eventos ocorrem no player.
- Uma API que fornece informações sobre o player - Essas informações incluem detalhes como o nome da mídia e a posição do indicador de reprodução.
Implementação do SDK
-
Sempre que um arquivo binário de biblioteca for mencionado, sua substituição XCFramework deverá ser usada em vez disso:
- MediaSDK.a > MediaSDK.xcframework
- MediaSDK_TV.a > MediaSDKTV.xcframework
-
Se você adicionar manualmente o Adobe XCFrameworks ao seu projeto, verifique se ele não está incorporado.
-
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:
- AdobeMobileLibrary.a
- MediaSDK.a
- libsqlite3.0.tbd
Públicos da Apple TV (tvOS):
- AdobeMobileLibrary_TV.a
- MediaSDK_TV.a
- libsqlite3.0.tbd
- SystemConfiguration.framework
-
Verifique se o aplicativo foi criado sem erros.
-
-
-
Importe a biblioteca.
code language-none #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ânciaMediaHeartbeat
, de modo a permitir um rastreamento preciso.Aqui está uma amostra de inicialização
ADBMediaHeartbeatConfig
:code language-none // 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
.code language-none @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
eADBMediaHeartBeatDelegate
para criar a instânciaADBMediaHeartbeat
.code language-none //Replace <ADBMediaHeartBeatDelegate> with your delegate instance _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate: <ADBMediaHeartBeatDelegate> config:config];
note important IMPORTANT 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.
Migração da versão 1.x para 2.x do iOS migrate-to-two-x
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.)
Configuração de um aplicativo nativo para tvOS
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 pastalib
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