Topik ini menjelaskan cara mengintegrasikan Short Video SDK untuk iOS menggunakan CocoaPods.
Prasyarat
Pastikan lingkungan pengembangan Anda memenuhi persyaratan berikut:
Item | Deskripsi |
Versi OS | iOS 9.0 atau yang lebih baru. |
Versi macOS High Sierra | macOS High Sierra 10.13 atau yang lebih baru. |
Versi Xcode | Xcode 9.0 atau yang lebih baru. Unduh Xcode. |
Informasi latar belakang
Short Video SDK tersedia dalam Edisi Profesional, Edisi Standar, dan Edisi Dasar. Ketiga edisi tersebut menggunakan pustaka AliVCSDK_ShortVideo.framework. Anda harus memperoleh lisensi untuk edisi yang sesuai dengan kebutuhan bisnis Anda.
Edisi Dasar hanya mencakup modul perekaman dan pemotongan (cropping).
Edisi Profesional dan Edisi Standar memiliki fitur lengkap. Anda harus memperoleh otorisasi terpisah untuk memanggil operasi API advanced dari Edisi Standar.
Untuk informasi pembaruan Short Video SDK, lihat catatan rilis.
Integrasi
Jika Anda perlu menggunakan Short Video SDK dan Player SDK sekaligus, kami menyarankan Anda mengintegrasikan ApsaraVideo MediaBox SDK. Solusi all-in-one ini mencegah konflik dependensi yang dapat muncul saat mengintegrasikan beberapa SDK secara terpisah. Untuk petunjuk integrasi, lihat ApsaraVideo MediaBox SDK untuk iOS.
Jika Anda ingin mengintegrasikan Short Video SDK dan Player SDK secara terpisah, Anda harus menggunakan versi Short Video SDK, Player SDK, dan AlivcFFmpeg yang kompatibel. Jika tidak, fitur-fitur SDK tersebut mungkin tidak berfungsi dengan benar. Untuk informasi selengkapnya, lihat dependensi versi AlivcFFmpeg.
Integrasi Pod
Tambahkan dependensi ke Podfile berdasarkan versi SDK.
PentingJika Anda menggunakan Short Video SDK 3.24.0 atau yang lebih baru, Anda harus menggunakan FFmpeg 4.3.0 atau yang lebih baru.
Pastikan jaringan Anda memungkinkan akses dan pembaruan repositori pod. Setelah menjalankan perintah pod install, verifikasi bahwa versi framework sesuai dengan versi terbaru di situs resmi.
Jika Anda mengintegrasikan Short Video SDK dengan dependensi minimal dan perlu mengunggah file media ke ApsaraVideo VOD, Anda juga harus mengintegrasikan Upload SDK. Untuk informasi selengkapnya, lihat Upload SDK.
Untuk V7.0.0 atau yang lebih baru
pod 'AliVCSDK_ShortVideo', '~> 7.11.0'Untuk V6.21.0 atau yang lebih lama
pod 'AliyunVideoSDKBasic', '~> 6.21.0' // Required for the Basic Edition pod 'AliyunVideoSDKStd', '~> 6.21.0' // Required for the Standard Edition pod 'AliyunVideoSDKPro', '~> 6.21.0' // Required for the Professional Edition
Perbarui repositori pod.
pod repo updateInstal pod.
pod install
Konfigurasi proyek
Setelah Anda mengintegrasikan SDK, buka proyek Anda di Xcode dan konfigurasikan pengaturan berikut:
Di Build Settings > Linking > Other Linker Flags, tambahkan flag -ObjC.
Di file Info.plist proyek Anda, tambahkan izin berikut:
Privacy - Camera Usage Description Privacy - Microphone Usage Description Privacy - Photo Library Usage Description
Konfigurasi lisensi
Setelah memperoleh lisensi, ikuti langkah-langkah berikut untuk mengonfigurasi file lisensi. Untuk informasi tentang cara memperoleh lisensi, lihat Memperoleh lisensi untuk Short Video SDK.
Impor file lisensi yang telah diunduh ke dalam proyek aplikasi Anda. Kemudian, di file Info.plist, tambahkan dua pasangan kunci-nilai. Untuk kunci pertama, masukkan AlivcLicenseKey dan atur nilainya ke kunci lisensi Anda. Untuk kunci kedua, masukkan AlivcLicenseFile dan atur nilainya ke path file lisensi yang disematkan relatif terhadap main bundle. Contohnya:
Kunci | Nilai |
AlivcLicenseKey | Kunci lisensi Anda. Contoh: MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1**** |
AlivcLicenseFile | Path file lisensi yang disematkan relatif terhadap main bundle. |
Langkah berikutnya
Integrasi Player
Jika Anda perlu mengintegrasikan Short Video SDK dan Player SDK untuk iOS ke dalam proyek Anda, kami menyarankan Anda menggunakan ApsaraVideo MediaBox SDK untuk iOS. Hal ini mencegah kegagalan kompilasi akibat adanya kelas duplikat.