Erste Schritte mit dem IVS iOs Player SDK - Amazon IVS
Empfohlen: Integrieren Sie das Player-SDK (Swift Package Manager)Alternative Methode: Integrieren Sie das Player-SDK (CocoaPods)Manuelles Installieren der FrameworkPlayer erstellenEinrichten der StellvertretungVideo anzeigenLaden eines StreamsWiedergeben eines StreamsPause bei App-HintergrundbildungSicherheit für den ThreadSDK-GrößeZusammenführung

Erste Schritte mit dem IVS iOs Player SDK

Dieses Dokument führt Sie durch die Schritte zum Einstieg in das Amazon IVS iOS Player SDK.

Wir empfehlen Ihnen, das SDK über Swift Package Manager zu integrieren. (Alternativ können Sie die Integration über CocoaPods vornehmen oder das Framework manuell zu Ihrem Projekt hinzufügen.)

Empfohlen: Integrieren Sie das Player-SDK (Swift Package Manager)

  1. Laden Sie die Datei Package.swift von https://player.live-video.net/1.43.0/Package.swift herunter.

  2. Erstellen Sie in Ihrem Projekt ein neues Verzeichnis mit dem Namen AmazonIVSBroadcast und fügen Sie es der Versionskontrolle hinzu.

  3. Platzieren Sie die heruntergeladene Datei Package.swift im neuen Verzeichnis.

  4. Gehen Sie in Xcode zu Datei > Paketabhängigkeiten hinzufügen und wählen Sie Lokal hinzufügen …

  5. Navigieren Sie zu dem von Ihnen erstellten AmazonIVSBroadcast-Verzeichnis, wählen Sie es aus und wählen Sie Paket hinzufügen aus.

  6. Wenn Sie aufgefordert werden, Paketprodukte für AmazonIVSPlayer auszuwählen, wählen Sie AmazonIVSPlayer als Ihr Paketprodukt aus, indem Sie Ihr Anwendungsziel im Abschnitt Zum Ziel hinzufügen festlegen.

  7. Wählen Sie Paket hinzufügen aus.

Alternative Methode: Integrieren Sie das Player-SDK (CocoaPods)

Wichtig: CocoaPods befindet sich im Wartungsmodus (nur Sicherheitskorrekturen) und nach Dezember 2026 können keine neuen Pakete oder Updates im CocoaPods veröffentlicht werden. Bestehende Pakete bleiben verfügbar, werden aber eingefroren. Wir empfehlen die Verwendung von Swift Package Manager für alle neuen Projekte.

Veröffentlichungen erfolgen über CocoaPods unter dem Namen AmazonIVSPlayer. Fügen Sie diese Abhängigkeit zu Ihrem Podfile hinzu: 

pod 'AmazonIVSPlayer'

Führen Sie pod install aus und das SDK wird in Ihrem .xcworkspace verfügbar sein.

Manuelles Installieren der Framework

  1. Laden Sie die neueste Version von https://player.live-video.net/1.43.0/AmazonIVSPlayer.xcframework.zip herunter.

  2. Extrahieren Sie den Inhalt des Archivs. AmazonIVSPlayer.xcframework enthält das SDK für Gerät und Simulator.

  3. Betten Sie AmazonIVSPlayer.xcframework ein, indem Sie es in den Abschnitt Rahmenbedingungen, Bibliotheken und eingebettete Inhalte auf der Registerkarte Allgemein für Ihr Anwendungsziel ziehen:

    Der Abschnitt Rahmenbedingungen, Bibliotheken und eingebettete Inhalte auf der Registerkarte Allgemein für Ihr Anwendungsziel.

Player erstellen

Das Player-Objekt ist IVSPlayer. Es kann initialisiert werden, wie unten gezeigt:

Swift
import AmazonIVSPlayer

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

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

Einrichten der Stellvertretung

Stellvertreter-Rückrufe bieten Informationen zum Wiedergabestatus, zu Ereignissen und Fehlern. Alle Callbacks werden in der Hauptwarteschlange aufgerufen.

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

Video anzeigen

Der Player zeigt das Video in einer benutzerdefinierten Ebene an, IVSPlayerLayer. Das SDK bietet auch IVSPlayerView, eine UIView-Unterklasse, die von dieser Ebene unterstützt wird. Verwenden Sie, was für die Benutzeroberfläche Ihrer Anwendung bequemer ist.

In beiden Fällen können Sie das Video von einer Player-Instance mithilfe der player-Eigenschaft anzeigen.

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;

Laden eines Streams

Der Player lädt den Stream asynchron. Sein Zustand zeigt an, wann es zum Spielen bereit ist.

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

Wiedergeben eines Streams

Wenn der Player bereit ist, verwenden Sie play, um die Wiedergabe zu starten. Verwenden Sie die Stellvertreter-Benutzeroberfläche oder die Schlüssel-Wert-Beobachtung auf der state-Eigenschaft, um die Statusänderung zu beobachten. Hier finden Sie ein Beispiel für den Stellvertreter-Ansatz:

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

Pause bei App-Hintergrundbildung

Der Player unterstützt keine Wiedergabe, während sich die App im Hintergrund befindet, muss aber nicht vollständig abgebrochen werden. Pausieren ist ausreichend; siehe Beispiele unten.

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

Sicherheit für den Thread

Die Player-API ist nicht Thread-sicher. Sie sollten eine Player-Instance aus dem Anwendungs-Hauptthread erstellen und verwenden.

SDK-Größe

Die Amazon IVS Player SDKs sind so leicht wie möglich. Aktuelle Informationen zur SDK-Größe finden Sie in den Versionshinweisen.

Wichtig: Bei der Bewertung der Auswirkungen auf die Größe ist die Größe des von Xcode erzeugten IPA nicht repräsentativ für die Größe Ihrer App, die auf das Gerät eines Benutzers heruntergeladen wurde. Der App Store führt Optimierungen durch, um die Größe Ihrer App zu reduzieren.

Zusammenführung

Das folgende einfache View-Controller-Snippet lädt und spielt eine URL in einer Playeransicht ab. Beachten Sie, dass die Eigenschaft playerView von einem XIB/Storyboard initialisiert wird und ihre Klasse im Interface Builder über den Abschnitt "Benutzerdefinierte Klasse" des Identitätsinspektors auf IVSPlayerView gesetzt wird.

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