Cara menginisialisasi Short Video SDK untuk iOS - ApsaraVideo VOD

Prasyarat

Sebelum menginisialisasi Short Video SDK untuk iOS, pastikan langkah-langkah berikut telah selesai.

Peroleh dan aktifkan lisensi Short Video SDK untuk Android. Untuk informasi lebih lanjut, lihat Memperoleh dan menggunakan lisensi Short Video SDK.
Short Video SDK untuk iOS telah diintegrasikan. Untuk versi V3.29.0 atau yang lebih baru, Anda perlu mengonfigurasi lisensi sebelum mendaftarkan SDK. Untuk informasi lebih lanjut, lihat Mengintegrasikan Short Video SDK untuk Android.

Impor file header

File header Short Video SDK mendefinisikan spesifikasi yang harus dipatuhi saat menggunakan metode-metode SDK. Untuk menggunakan SDK ini, Anda harus terlebih dahulu mengimpor file header.

#import <AliyunVideoSDKPro/AliyunVideoSDKPro.h>

Daftarkan Short Video SDK untuk iOS

Jika Anda menggunakan Short Video SDK versi 3.29.0 atau yang lebih baru, Anda harus mendaftarkan SDK setelah memulai aplikasi. Jika tidak, SDK tidak dapat digunakan. Kode berikut menunjukkan cara mendaftarkan SDK dari berbagai versi.

// Daftarkan Short Video SDK V3.30.0 atau yang lebih baru.
NSError *error = [AliyunVideoSDKInfo registerSDK]; // Jika nil dikembalikan, pendaftaran berhasil. 
// Dalam banyak kasus, kegagalan pendaftaran disebabkan oleh masalah integrasi lisensi. Kami sarankan Anda menambahkan fungsi Assert dalam kode Anda. Dengan cara ini, jika terjadi kesalahan selama pendaftaran SDK, sistem akan mengembalikan pesan kesalahan dan memberikan saran tentang cara memperbaiki kesalahan tersebut. 
NSAssert2(error == nil, @"Pendaftaran SDK gagal. %@;%@", error.localizedDescription, error.localizedRecoverySuggestion);

// Daftarkan Short Video SDK 3.29.0.
// Ubah nama file lisensi menjadi license.crt dan tambahkan ke proyek aplikasi Anda. Kemudian, gunakan kode berikut untuk mendapatkan direktori tempat file lisensi disimpan. 
NSString *licenseFilePath = [NSBundle.mainBundle pathForResource:@"license" ofType:@"crt"];
// Daftarkan SDK dengan menggunakan kunci lisensi dan jalur file lisensi yang diperoleh. 
[AliyunVideoSDKInfo registerSDKWithLicenseKey:LicenseKey licenseFile:licenseFilePath];

Penting

Jika kunci lisensi dan file lisensi berhasil diimpor ke SDK, pendaftaran dianggap berhasil. Namun, pendaftaran yang berhasil tidak menjamin bahwa autentikasi juga berhasil.

Gunakan kode berikut untuk melihat status lisensi:

AliyunVideoLicense *license = AliyunVideoLicenseManager.CurrentLicense;

Saat menggunakan fitur tertentu atau layanan bernilai tambah, autentikasi SDK diperlukan. Anda dapat memperoleh hasil autentikasi dari respons Operasi API jika autentikasi gagal. Anda juga dapat mendengarkan hasil autentikasi pada listener.

// Peroleh hasil autentikasi untuk Short Video SDK V3.30.0 atau yang lebih baru.
AliyunVideoLicenseManager.EventDelegate = self; // Untuk informasi lebih lanjut, lihat deskripsi AliyunVideoLicenseEventDelegate.

Lihat hasil autentikasi:

AliyunVideoLicenseResultCode code = [AliyunVideoLicenseManager check];

Jika Anda telah memperbarui lisensi atau membeli layanan bernilai tambah, gunakan kode berikut untuk memperbarui lisensi. Secara default, sistem akan memperbarui lisensi setiap 15 menit.

[AliyunVideoLicenseManager Refresh:^(AliyunVideoLicenseRefreshCode code){
    // Informasi tentang hasil verifikasi lisensi.
}];

Tentukan jalur paket sumber daya

Jika Anda mengintegrasikan Short Video SDK dengan metode integrasi dependensi minimal tetapi ingin menambahkan paket sumber daya AliyunVideoSDKPro.bundle, Anda dapat mengunduh paket tersebut secara otomatis saat menjalankan aplikasi. Setelah unduhan selesai, paket sumber daya akan ditambahkan ke SDK.

Unggah paket sumber daya ke cloud. Misalnya, Anda dapat mengunggahnya ke bucket Object Storage Service (OSS).
Periksa apakah paket sumber daya sudah ada saat aplikasi dimulai. Jika tidak ada, sistem akan mengunduh paket tersebut ke perangkat lokal Anda. Jika sudah ada, lanjutkan ke langkah berikutnya.

Tentukan jalur penyimpanan paket sumber daya. Contoh kode:

[AliyunVideoSDKInfo setSDKBundlePath:@"Jalur tempat bundel sumber daya disimpan di perangkat lokal"];

Keluaran log

Secara default, Short Video SDK menghasilkan log peringatan dan kesalahan pada level AlivcLogWarn. Anda dapat menyetel level log untuk menghasilkan lebih banyak detail log guna membantu pemecahan masalah.

// Level log berikut didukung:
typedef NS_ENUM(NSInteger, AlivcLogLevel)
{
    AlivcLogClose = 1,
    AlivcLogVerbose,
    AlivcLogDebug,
    AlivcLogInfo,
    AlivcLogWarn,
    AlivcLogError,
    AlivcLogFatal
};
// Tentukan level log yang akan dihasilkan.
[AliyunVideoSDKInfo setLogLevel:AlivcLogDebug];

Kueri informasi versi

Gunakan kode berikut untuk menampilkan informasi versi Short Video SDK. Ini membantu Anda memverifikasi versi SDK yang diintegrasikan serta memecahkan masalah yang mungkin terjadi selama penggunaan SDK.

[AliyunVideoSDKInfo printSDKInfo];

Anda juga dapat mencetak informasi sesuai kebutuhan.

NSString *version = [AliyunVideoSDKInfo version]; // Nomor versi.
NSString *module = [AliyunVideoSDKInfo module]; // Jenis versi.
int moduleCode =[AliyunVideoSDKInfo versionCode]; // Tampilkan kode jenis versi.
NSString *buildId =[AliyunVideoSDKInfo videoSDKBuildId]; // Tampilkan ID build versi SDK.
NSLog(@"\n==============\nVERSION: %@\nBUILD_ID: %@\nMODULE: %@\nMODULE_CODE: %d\n==============", version, buildId, module, moduleCode);