全部产品
Search
文档中心

ApsaraVideo VOD:Integrasikan SDK

更新时间:Jan 29, 2026

Topik ini menjelaskan cara mengintegrasikan SDK video pendek untuk iOS menggunakan pods.

Prasyarat

Tabel berikut mencantumkan persyaratan untuk lingkungan pengembangan.

Category

Description

System version

iOS 9.0 atau versi yang lebih baru didukung.

Versi macOS High Sierra

macOS High Sierra 10.13 atau versi yang lebih baru didukung.

Versi Xcode

Xcode 9.0 atau versi yang lebih baru didukung. Unduh Xcode.

Informasi latar belakang

SDK video pendek tersedia dalam Edisi Dasar, Edisi Standar, dan Edisi Profesional. Ketiga edisi tersebut menggunakan library AliVCSDK_ShortVideo.framework. Anda harus mengaktifkan lisensi untuk edisi yang sesuai dengan kebutuhan bisnis Anda.

  • Edisi Dasar hanya mencakup fitur perekaman dan pemotongan.

  • Edisi Profesional dan Edisi Standar mencakup semua fitur. Pemanggilan API advanced dari Edisi Standar memerlukan otorisasi terpisah.

Catatan

Untuk informasi tentang pembaruan fitur SDK video pendek, lihat Catatan rilis.

Petunjuk integrasi

  • Jika Anda ingin menggunakan SDK video pendek dan SDK player secara bersamaan, integrasikan SDK MediaBox all-in-one. Hal ini mencegah konflik library dependensi yang dapat terjadi ketika Anda mengintegrasikan beberapa SDK secara terpisah. Untuk informasi selengkapnya tentang integrasi, lihat iOS.

  • Jika Anda mengintegrasikan SDK video pendek dan SDK player secara terpisah, Anda harus mempertimbangkan dependensi versi antara SDK video pendek, SDK player, dan AlivcFFmpeg. Jika tidak, fitur-fitur pada SDK video pendek atau SDK player mungkin tidak berfungsi sebagaimana mestinya. Untuk informasi selengkapnya, lihat Dependensi versi AlivcFFmpeg.

Integrasikan SDK menggunakan pods

  1. Tambahkan dependensi ke Podfile. Dependensi untuk versi yang berbeda adalah sebagai berikut:

    Penting
    • Jika Anda menggunakan SDK video pendek V3.24.0 atau versi yang lebih baru, Anda harus menggunakan FFmpeg V4.3.0 atau versi yang lebih baru.

    • Pastikan lingkungan jaringan Anda memungkinkan akses dan pembaruan repositori pod. Setelah menjalankan perintah `pod install`, verifikasi bahwa versi framework sesuai dengan versi terbaru yang tersedia di website resmi.

    • Jika Anda mengintegrasikan SDK video pendek dengan dependensi minimum, Anda juga harus mengintegrasikan unggah SDK untuk mengunggah aset media ke ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Unggah SDK.

    • Integrasi untuk V7.0.0 dan versi yang lebih baru

      pod 'AliVCSDK_ShortVideo', '~> 7.10.0'
    • Integrasi untuk V6.21.0 dan versi yang lebih lama

      pod 'AliyunVideoSDKBasic', '~> 6.21.0' // Integrasikan Edisi Dasar
      pod 'AliyunVideoSDKStd', '~> 6.21.0'	// Integrasikan Edisi Standar
      pod 'AliyunVideoSDKPro', '~> 6.21.0'	// Integrasikan Edisi Profesional
  2. Perbarui repositori pod.

    pod repo update
  3. Instal pod.

    pod install

Konfigurasi proyek

Setelah Anda mengintegrasikan SDK, buka proyek dan konfigurasikan pengaturan berikut:

  1. Buka Build Settings > Linking > Other Linker Flags dan tambahkan -ObjC.

  2. Buka file info.plist proyek dan tambahkan izin berikut:

    Privacy - Camera Usage Description
    Privacy - Microphone Usage Description
    Privacy - Photo Library Usage Description

Konfigurasi lisensi

Setelah Anda mendapatkan lisensi, Anda harus mengonfigurasi file lisensi. Untuk informasi selengkapnya tentang cara mendapatkan lisensi, lihat Dapatkan lisensi untuk SDK video pendek.

Impor file lisensi yang telah diunduh ke dalam proyek aplikasi Anda. Tambahkan dua kunci ke file Info.plist. Atur nilai kunci AlivcLicenseKey ke nilai LicenseKey Anda. Atur nilai kunci AlivcLicenseFile ke path file sertifikat bawaan relatif terhadap main bundle. Tabel berikut menjelaskan kunci-kunci tersebut:

Key

Value

AlivcLicenseKey

Nilai LicenseKey. Contoh: MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****

AlivcLicenseFile

Path file sertifikat bawaan relatif terhadap main bundle.

Langkah selanjutnya

Inisialisasi SDK

Integrasi Player

Jika Anda ingin mengintegrasikan SDK video pendek untuk iOS dan SDK player ke dalam proyek Anda, gunakan SDK all-in-one untuk iOS guna mencegah masalah duplikasi class yang dapat menyebabkan kegagalan kompilasi.

Referensi