Integrasikan ApsaraVideo Player SDK untuk iOS dengan cepat - ApsaraVideo VOD

Integrasikan ApsaraVideo Player SDK untuk iOS ke dalam proyek Anda dengan cepat.

Persyaratan

Sistem operasi: iOS 8.0 atau versi lebih baru.
Alat pengembangan: Xcode direkomendasikan. Topik ini menggunakan Xcode. Unduh di: ‎Xcode.
ApsaraVideo Player SDK untuk iOS tidak mendukung simulator. Anda harus menjalankan aplikasi pada perangkat fisik.

Prasyarat

Anda telah memperoleh file lisensi untuk otorisasi pemutar, seperti AliVideoCert-********.crt. Untuk informasi selengkapnya, lihat Dapatkan lisensi.
Untuk integrasi manual, unduh paket ApsaraVideo Player SDK untuk iOS versi terbaru. Lihat unduh.

Catatan penggunaan

Saat membuat paket aplikasi, file dSYM digunakan untuk mensimbolisasi laporan crash.
ApsaraVideo Player SDK untuk iOS memerlukan framework AlivcFFmpeg dan AliyunPlayer. File header pemutar berada di AliyunPlayer.
Jika Anda mengintegrasikan SDK pemutar dan SDK video pendek secara bersamaan, pastikan kompatibilitas versi antara SDK video pendek, SDK pemutar, dan AlivcFFmpeg. Ketidaksesuaian versi dapat menyebabkan fitur gagal berfungsi. Untuk informasi selengkapnya, lihat dependensi AlivcFFmpeg.
Paket ApsaraVideo Player SDK untuk iOS mencakup arsitektur simulator. Hapus arsitektur tersebut sebelum mengirimkan aplikasi Anda ke App Store agar tidak ditolak.

Langkah 1: Integrasikan SDK

Integrasi CocoaPods

Instal CocoaPods. Ini memerlukan lingkungan Ruby.

// Di Terminal, jalankan perintah berikut:
sudo gem install cocoapods

Verifikasi instalasi CocoaPods.

Jalankan pod --version di terminal Anda untuk memverifikasi instalasi.
```
xxx@ ~ % pod --version
1.16.2
```

Buat Podfile.

Di terminal Anda, navigasi ke direktori proyek dan jalankan pod init untuk membuat Podfile.

// Masuk ke direktori proyek Anda.
xxx@ ~ %  cd /path/yourProject
// Hasilkan Podfile.
xxx@ yourProject % pod init

Edit Podfile untuk menambahkan dependensi SDK pemutar.
Catatan
- Untuk mengintegrasikan SDK pemutar dan SDK video pendek secara bersamaan, ganti AliPlayerSDK_iOS dalam kode berikut dengan AliPlayerPartSDK_iOS. AliPlayerPartSDK_iOS tidak menyertakan FFmpeg, sehingga mencegah konflik dengan FFmpeg di SDK video pendek.
- Masukkan nomor versi yang benar untuk SDK pemutar. Jika tidak, impor akan gagal dan menampilkan error. Untuk versi SDK pemutar, lihat Catatan Rilis ApsaraVideo Player SDK untuk iOS.
```
source 'https://github.com/CocoaPods/Specs.git'
platform:ios, '8.0'

target 'yourProject' do
    # SDK Pemutar. Kami merekomendasikan penggunaan versi terbaru.
    pod 'AliPlayerSDK_iOS'
end
```

(Opsional) Tambahkan dependensi pada versi tertentu dari SDK pemutar.

source 'https://github.com/CocoaPods/Specs.git'
platform:ios, '8.0'

player_sdk_version = '7.17.0'

target 'yourProject' do
    # SDK Pemutar. Kami merekomendasikan penggunaan versi terbaru.
    pod 'AliPlayerSDK_iOS' , player_sdk_version
end

Instal dependensi.

Jalankan perintah berikut untuk menginstal dependensi.

pod install

Output berikut menunjukkan instalasi berhasil.

xxx@ yourProject % pod install
Analyzing dependencies
Downloading dependencies
Installing AliPlayerSDK_iOS (7.17.0)
Generating Pods project
Integrating client project
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

Jalankan perintah berikut untuk memperbarui SDK pemutar.

pod update AliPlayerSDK_iOS

Integrasi manual

Catatan

Jika Anda mengintegrasikan SDK pemutar dan SDK video pendek secara bersamaan, impor hanya satu framework AlivcFFmpeg dan pastikan Anda menggunakan versi yang benar.

Unduh ApsaraVideo Player SDK untuk iOS.
Tambahkan framework pemutar ke Frameworks, Libraries, and Embedded Content, dan atur Embed menjadi Embed & Sign.
- alivcffmpeg.framework: Framework dasar untuk pemutar.
- AliyunMediaDownloader.framework: Digunakan untuk unduhan offline.
- AliyunPlayer.framework: Framework pemutar.
Klik tab Build Settings.
Di bagian Search Paths, atur Framework Search Paths ke direktori framework lokal Anda.

(Opsional) Integrasi RTS (CocoaPods)

Untuk mengintegrasikan komponen Real-Time Streaming (RTS), lihat Implementasikan penarikan aliran berbasis RTS di iOS.

Langkah 2: Konfigurasikan lisensi

Penting

Saat menggunakan pemutar di wilayah luar Tiongkok daratan, Hong Kong, dan Makau (situs internasional), Anda harus memanggil API berikut untuk mengatur lingkungan sebelum memanggil API pemutar lainnya.

Metode 1: Panggil API berikut untuk memperbarui konfigurasi default ke lingkungan situs internasional.

// Untuk situs internasional, Anda harus memanggil API ini sebelum API pemutar lainnya
// untuk mengatur lingkungan. Pengaturan ini tidak dapat diubah saat waktu proses.
AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;

Metode 2 (Direkomendasikan): Untuk versi SDK pemutar 7.6.0 dan lebih baru, Anda dapat mengonfigurasi lingkungan situs internasional di file Info.plist.

Buka file Info.plist dan ubah nilai AlivcEnv menjadi SEA.
```
// Konfigurasikan lingkungan saat ini sebagai situs internasional.
<key>AlivcEnv</key>
<string>SEA</string>
```
Gambar berikut menunjukkan contoh konfigurasi:

Untuk mengonfigurasi lisensi pada klien iOS Anda, lihat Konfigurasikan lisensi di iOS.

Langkah 3: Aktifkan logging (Opsional)

Aktifkan logging untuk membantu troubleshooting masalah. Untuk petunjuk cara memperoleh log, lihat Peroleh log SDK.

// Aktifkan logging.
[AliPlayer setEnableLog:YES];
// Atur tingkat log. Default-nya adalah LOG_LEVEL_INFO. Untuk troubleshooting, atur ke LOG_LEVEL_TRACE.
[AliPlayer setLogCallbackInfo:LOG_LEVEL_INFO callbackBlock:nil];

Struktur proyek

Framework	Deskripsi
alivcffmpeg.framework	Framework dasar untuk pemutar. Wajib.
AliyunMediaDownloader.framework	Digunakan untuk unduhan offline. Opsional.
AliyunPlayer.framework	Framework pemutar. Wajib.
artcSource.framework	Mendukung protokol ARTC. Opsional. Catatan Untuk mendukung protokol ARTC, Anda juga harus menambahkan RtsSDK.framework. Untuk detail integrasi, lihat Implementasikan penarikan aliran berbasis RTS di iOS.
aemFilter.framework	Mengaktifkan peningkatan audio. Opsional.
libPluginSR.framework	Mengaktifkan super-resolusi. Opsional.
normalsrFilter.framework	Mengaktifkan super-resolusi. Opsional.
srFilter.framework	Mengaktifkan super-resolusi. Opsional.
vfiFilter.framework	Mengaktifkan penyisipan frame video. Opsional.
vvcCodecPlugin.framework	Plugin decoding H.266. Opsional.

FAQ

Menggunakan CocoaPods

// Pisahkan proyek Anda dari dependensi CocoaPods.
pod deintegrate 

// Perbarui indeks repositori sumber CocoaPods lokal Anda.
// Kasus penggunaan:
// - Saat Anda menambahkan dependensi baru, ini memastikan Anda dapat mengambil versi terbaru yang tersedia.
// - Saat versi pustaka tertentu tidak tersedia atau Anda tahu ada versi baru tetapi tidak muncul di proyek Anda, gunakan perintah ini untuk memperbarui.
pod repo update

// Perbarui Pods proyek.
// Kasus penggunaan:
// - Gunakan ini saat Anda ingin memperbarui semua pods di proyek ke versi terbaru yang didukung sesuai Podfile Anda.
pod update

// Menjalankan fungsi yang sama seperti 'pod install' tetapi memaksa pembaruan indeks repositori CocoaPods lokal sebelum instalasi.
// Kasus penggunaan:
// - Ini adalah perintah yang baik untuk digunakan saat Anda menambahkan pustaka baru atau ingin menggunakan versi terbaru dari pustaka yang ditentukan dalam Podfile Anda, terutama jika Anda melihat pesan error yang menunjukkan bahwa versi pustaka yang diperlukan tidak tersedia.
pod install --repo-update

// Bersihkan cache Pods.
// Catatan:
// 1. Membersihkan cache tidak mengubah Podfile.lock atau Podfile Anda. Saat Anda menjalankan 'pod install' atau 'pod update', CocoaPods mengunduh ulang pustaka yang diperlukan berdasarkan manifes dan lockfile Anda.
// 2. Membersihkan cache bukan langkah rutin dan hanya boleh digunakan untuk menyelesaikan masalah tertentu. Biasanya, CocoaPods mengelola cache-nya dengan baik.
pod cache clean --all

Konflik simbol dengan AlivcFFmpeg

Solusi:

Jika Anda mengalami konflik simbol dengan AlivcFFmpeg, hapus dependensi yang berlebihan. Pertahankan versi yang disediakan bersama ApsaraVideo Player SDK untuk iOS dan hapus yang berasal dari pihak ketiga. Hal ini mungkin memengaruhi fungsionalitas pemutar pihak ketiga.

Kesalahan Sandbox

Masalah:
Solusi:

Di UserSetting, atur User Script SandBoxing menjadi NO.

Integrasi SDK video pendek

Untuk mengintegrasikan ApsaraVideo Player SDK untuk iOS dan SDK video pendek secara bersamaan, gunakan SDK all-in-one untuk iOS guna menghindari masalah duplikasi kelas dan kegagalan kompilasi.

Untuk masalah pemutar lainnya beserta solusinya, lihat FAQ tentang ApsaraVideo Player.

Referensi

Fitur dasar

Fitur lanjutan