Memulai IVS iOS Player SDK - Amazon IVS
Direkomendasikan: Integrasikan SDK Pemain (Swift Package Manager)Pendekatan Alternatif: Integrasikan SDK Pemain () CocoaPodsPendekatan Alternatif: Instal Kerangka Secara ManualBuat PemainMengatur DelegasiTampilan VideoMemuat StreamMainkan StreamingJeda Pada Latar Belakang AplikasiKeamanan BenangUkuran SDKMenyatukan Semuanya

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai IVS iOS Player SDK

Dokumen ini membawa Anda melalui langkah-langkah yang terlibat dalam memulai dengan SDK pemutar iOS Amazon IVS.

Kami menyarankan Anda mengintegrasikan SDK pemain melalui Swift Package Manager. (Sebagai alternatif, Anda dapat mengintegrasikan melalui CocoaPods atau menambahkan kerangka kerja secara manual ke proyek Anda.)

Direkomendasikan: Integrasikan SDK Pemain (Swift Package Manager)

  1. Unduh file Package.swift dari https://player.live-video.net/1.43.0/Package.swift.

  2. Dalam proyek Anda, buat direktori baru bernama Amazon IVSPlayer dan tambahkan ke kontrol versi.

  3. Letakkan file Package.swift yang diunduh di direktori baru.

  4. Di Xcode, buka File > Add Package Dependencies dan pilih Add Local...

  5. Arahkan ke dan pilih IVSPlayer direktori Amazon yang Anda buat, lalu pilih Add Package.

  6. Saat diminta untuk Memilih Produk Paket untuk AmazonIVSPlayer, pilih Amazon IVSPlayer sebagai Produk Package Anda dengan menetapkan target aplikasi Anda di bagian Tambahkan ke Target.

  7. Pilih Add Package.

Pendekatan Alternatif: Integrasikan SDK Pemain () CocoaPods

CocoaPods Penting: dalam mode pemeliharaan (hanya perbaikan keamanan) dan setelah Desember 2026, tidak ada paket atau pembaruan baru yang dapat dipublikasikan ke repositori. CocoaPods Paket yang ada akan tetap tersedia tetapi dibekukan. Kami merekomendasikan menggunakan Swift Package Manager untuk semua proyek baru.

Rilis diterbitkan melalui CocoaPods di bawah namaAmazonIVSPlayer. Tambahkan dependensi ini ke Podfile Anda: 

pod 'AmazonIVSPlayer'

Jalankan pod install dan SDK akan tersedia di .xcworkspace Anda.

Pendekatan Alternatif: Instal Kerangka Secara Manual

  1. Unduh versi terbaru dari https://player.live-video.net/1.43.0/Amazon IVSPlayer .xcframework.zip.

  2. Ekstrak konten arsip. AmazonIVSPlayer.xcframework berisi SDK untuk perangkat dan simulator.

  3. Sematkan AmazonIVSPlayer.xcframework dengan menyeretnya ke bagian Frameworks, Libraries, dan Embedded Content pada tab General untuk target aplikasi Anda:

    Bagian Kerangka Kerja, Pustaka, dan Konten Tersemat pada tab Umum untuk target aplikasi Anda.

Buat Pemain

Objek pemain adalahIVSPlayer. Hal ini dapat diinisialisasi seperti yang ditunjukkan di bawah ini:

Swift
import AmazonIVSPlayer

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

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

Mengatur Delegasi

Delegasi callback memberikan informasi tentang status pemutaran, peristiwa, dan kesalahan. Semua callback dipanggil pada antrian utama.

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

Tampilan Video

Pemutar menampilkan video dalam lapisan khusus,IVSPlayerLayer. SDK juga menyediakanIVSPlayerView, UIView subclass yang didukung oleh lapisan ini. Gunakan mana saja yang lebih nyaman untuk UI aplikasi Anda.

Dalam kedua kasus, tampilkan video dari instance pemutar dengan menggunakan player properti.

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;

Memuat Stream

Pemain memuat aliran secara asinkron. Keadaannya menunjukkan kapan siap untuk bermain.

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

Mainkan Streaming

Saat pemain sudah siap, gunakan play untuk memulai pemutaran. Gunakan antarmuka delegasi atau pengamatan nilai kunci pada state properti untuk mengamati perubahan status. Berikut adalah contoh pendekatan berbasis delegasi:

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

Jeda Pada Latar Belakang Aplikasi

Pemain tidak mendukung pemutaran saat aplikasi berada di latar belakang, tetapi tidak perlu dirobohkan sepenuhnya. Menjeda sudah cukup; lihat contoh di bawah ini.

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

Keamanan Benang

API pemain tidak aman untuk utas. Anda harus membuat dan menggunakan instance pemain dari thread utama aplikasi.

Ukuran SDK

Pemutar Amazon IVS SDKs dirancang agar seringan mungkin. Untuk informasi terkini tentang ukuran SDK, lihat Catatan Rilis.

Penting: Saat mengevaluasi dampak ukuran, ukuran IPA yang dihasilkan oleh Xcode tidak mewakili ukuran aplikasi yang diunduh ke perangkat pengguna. App Store melakukan pengoptimalan untuk mengurangi ukuran aplikasi Anda.

Menyatukan Semuanya

Cuplikan view-controller sederhana berikut memuat dan memainkan URL dalam tampilan pemain. Perhatikan bahwa playerView properti diinisialisasi dari Xib/Storyboard, dan kelasnya diatur ke IVSPlayerView Interface Builder menggunakan bagian Custom Class dari Identity Inspector.

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