Conceitos básicos do SDK do reprodutor para o iOS do IVS - Amazon IVS
Recomendado: integrar o SDK do player (Swift Package Manager)Abordagem alternativa: integrar o SDK do player (CocoaPods)Abordagem alternativa: instalar o framework manualmenteCriar playerConfigurar representanteExibir vídeoCarregar um streamReproduzir um streamPausar no plano de fundo da aplicaçãoSegurança de threadTamanho do SDKReunir todos os componentes

Conceitos básicos do SDK do reprodutor para o iOS do IVS

Este documento descreve as etapas envolvidas ao começar a usar o SDK do reprodutor para o iOS do Amazon IVS.

Recomendamos integrar o SDK do player usando o Swift Package Manager. (Como alternativa, você pode integrar usando o CocoaPods ou adicionar manualmente a estrutura ao projeto.)

Recomendado: integrar o SDK do player (Swift Package Manager)

  1. Baixe o arquivo Package.swift de https://player.live-video.net/1.43.0/Package.swift.

  2. No projeto, crie um novo diretório denominado AmazonIVSPlayer e adicione-o ao controle de versão.

  3. Coloque o arquivo Package.swift que foi baixado no novo diretório.

  4. No Xcode, vá para Arquivo > Adicionar dependências de pacote e selecione Adicionar local....

  5. Navegue e selecione o diretório AmazonIVSPlayer que você criou e selecione Adicionar pacote.

  6. Quando receber o prompt Escolha produtos de pacote para o AmazonIVSPlayer, selecione AmazonIVSPlayer como o produto de pacote definindo o destino da aplicação na seção Adicionar ao destino.

  7. Selecione Adicionar pacote.

Abordagem alternativa: integrar o SDK do player (CocoaPods)

Importante: o CocoaPods está no modo de manutenção (apenas correções de segurança) e, após dezembro de 2026, novos pacote e atualizações não poderão mais ser publicados no repositório do CocoaPods. Os pacotes existentes permanecerão disponíveis, mas congelados. Recomendamos usar o Swift Package Manager para todos os projetos novos.

Os lançamentos são publicados via CocoaPods sob o nome AmazonIVSPlayer. Adicione esta dependência ao seu Podfile: 

pod 'AmazonIVSPlayer'

A execução do pod install e do SDK estará disponível em seu .xcworkspace.

Abordagem alternativa: instalar o framework manualmente

  1. Faça download da versão mais recente de https://player.live-video.net/1.43.0/AmazonIVSPlayer.xcframework.zip.

  2. Extraia o conteúdo do arquivo. AmazonIVSPlayer.xcframework contém o SDK para dispositivo e para o simulador.

  3. Incorporar o AmazonIVSPlayer.xcframework arrastando-o para a seção Estruturas, bibliotecas e conteúdo incorporado da guia Geral para o destino da sua aplicação:

    A seção Estruturas de trabalho, bibliotecas e conteúdo incorporado da guia Geral para o destino da sua aplicação.

Criar player

O objeto do player é IVSPlayer. Ele pode ser inicializado como mostrado abaixo:

Swift
import AmazonIVSPlayer

let player = IVSPlayer()
Objective-C
#import <AmazonIVSPlayer/AmazonIVSPlayer.h>

IVSPlayer *player = [[IVSPlayer alloc] init];

Configurar representante

Os retornos de chamada do representante fornecem informações sobre o estado da reprodução, eventos e erros. Todos os retornos de chamada são chamados na fila principal.

Swift
// Self must conform to IVSPlayer.Delegate
player.delegate = self
Objective-C
// Self must conform to IVSPlayer.Delegate
player.delegate = self

Exibir vídeo

O player exibe vídeo em uma camada personalizada, IVSPlayerLayer. O SDK do também fornece IVSPlayerView, uma subclasse de UIView apoiada por esta camada. Use o que for mais conveniente para a interface do usuário da sua aplicação.

Em ambos os casos, exiba o vídeo de uma instância do player usando a propriedade player.

Swift
// When using IVSPlayerView:
playerView.player = player

// When using IVSPlayerLayer:
playerLayer.player = player
Objective-C
// When using IVSPlayerView:
playerView.player = player;

// When using IVSPlayerLayer:
playerLayer.player = player;

Carregar um stream

O player carrega o stream de forma assíncrona. Seu estado indica quando ele está pronto para reprodução.

Swift
player.load(url)
Objective-C
[player load:url];

Reproduzir um stream

Quando o player estiver pronto, use playpara iniciar a reprodução. Use a interface do representante ou a observação de chave-valor na propriedade state para observar a mudança de estado. Veja a seguir o exemplo da abordagem baseada em representante:

Swift
func player(_ player: IVSPlayer, didChangeState state: IVSPlayer.State) {
    if state == .ready {
        player.play()
    }
}
Objective-C
- (void)player:(IVSPlayer *)player didChangeState:(IVSPlayerState)state {
    if (state == IVSPlayerStateReady) {
        [player play];
    }
}

Pausar no plano de fundo da aplicação

O player não suporta a reprodução enquanto a aplicação estiver em segundo plano, mas não precisa ser totalmente desativado. Pausar é suficiente; veja os exemplos abaixo.

Swift
override func viewDidLoad() {
    super.viewDidLoad()

    NotificationCenter.default.addObserver(self,
        selector: #selector(applicationDidEnterBackground(_:)),
        name: UIApplication.didEnterBackgroundNotification,
        object: nil)
}

@objc func applicationDidEnterBackground(_ notification: NSNotification) {
    playerView?.player?.pause()
}
Objective-C
- (void)viewDidLoad {
    [super viewDidLoad];

    NSNotificationCenter *defaultCenter = NSNotificationCenter.defaultCenter;
    [defaultCenter addObserver:self
                      selector:@selector(applicationDidEnterBackground:)
                          name:UIApplicationDidEnterBackgroundNotification
                        object:nil];
}

- (void)applicationDidEnterBackground:(NSNotification *)notification {
    [playerView.player pause];
}

Segurança de thread

A API do player não é um thread seguro. Você deve criar e usar uma instância do player a partir do thread principal da aplicação.

Tamanho do SDK

Os SDKs do Amazon IVS Player foram projetados para serem o mais leve possível. Para obter informações atuais sobre o tamanho do SDK, consulte as Notas de release.

Importante: ao avaliar o impacto do tamanho, o tamanho do IPA produzido pelo Xcode não representa o tamanho da aplicação baixada no dispositivo do usuário. A App Store realiza otimizações para reduzir o tamanho de sua aplicação.

Reunir todos os componentes

O seguinte snippet simples do controlador de exibição carrega e reproduz um URL em uma exibição de player. Observe que a propriedade playerView é inicializada a partir de um XIB/Storyboard, e sua classe é definida como IVSPlayerView no Construtor de interface usando a seção Classe personalizada do Inspector de identidade.

Swift
import AmazonIVSPlayer

class MyViewController: UIViewController {
...
    // Connected in Interface Builder
    @IBOutlet var playerView: IVSPlayerView!

    override func viewDidLoad() {
        super.viewDidLoad()

        NotificationCenter.default.addObserver(self,
            selector: #selector(applicationDidEnterBackground(_:)),
            name: UIApplication.didEnterBackgroundNotification,
            object: nil)
    }

    @objc func applicationDidEnterBackground(_ notification: NSNotification) {
        playerView?.player?.pause()
    }
...
    // Assumes this view controller is already loaded.
    // For example, this could be called by a button tap.
    func playVideo(url videoURL: URL) {
        let player = IVSPlayer()
        player.delegate = self
        playerView.player = player
        player.load(videoURL)
    }
}

extension MyViewController: IVSPlayer.Delegate {
    func player(_ player: IVSPlayer, didChangeState state: IVSPlayer.State) {
        if state == .ready {
            player.play()
        }
    }
}
Objective-C
// MyViewController.h

@class IVSPlayerView;

@interface MyViewController: UIViewController
...
// Connected in Interface Builder
@property (nonatomic) IBOutlet IVSPlayerView *playerView;
...
@end


// MyViewController.m

#import <AmazonIVSPlayer/AmazonIVSPlayer.h>

@implementation MyViewController <IVSPlayerDelegate>
...

- (void)viewDidLoad {
    [super viewDidLoad];

    NSNotificationCenter *defaultCenter = NSNotificationCenter.defaultCenter;
    [defaultCenter addObserver:self
                      selector:@selector(applicationDidEnterBackground:)
                          name:UIApplicationDidEnterBackgroundNotification
                        object:nil];
}

- (void)applicationDidEnterBackground:(NSNotification *)notification {
    [playerView.player pause];
}

// Assumes this view controller is already loaded.
// For example, this could be called by a button tap.
- (void)playVideoWithURL:(NSURL *)videoURL {
    IVSPlayer *player = [[IVSPlayer alloc] init];
    player.delegate = self;
    playerView.player = player;
    [player load:videoURL];
}

- (void)player:(IVSPlayer *)player didChangeState:(IVSPlayerState)state {
    if (state == IVSPlayerStateReady) {
        [player play];
    }
}

...
@end