Cara menginisialisasi SDK video pendek untuk iOS - ApsaraVideo VOD

Prasyarat

Lengkapi langkah-langkah berikut sebelum menginisialisasi SDK:

Dapatkan dan aktifkan lisensi untuk SDK video pendek. Untuk informasi selengkapnya, lihat Dapatkan lisensi untuk SDK video pendek.
Integrasikan SDK video pendek. Mulai versi 3.29.0, Anda harus mengonfigurasi lisensi sebelum mendaftarkan SDK. Untuk informasi selengkapnya, lihat Integrasikan SDK.

Impor file header

Impor file header SDK sebelum menggunakan SDK video pendek. File header tersebut berisi deklarasi API yang diperlukan oleh SDK.

#import <AliyunVideoSDKPro/AliyunVideoSDKPro.h>

Daftarkan SDK

Mulai versi 3.29.0, SDK video pendek menggunakan layanan lisensi yang ditingkatkan. Daftarkan SDK setelah aplikasi Anda dimulai agar fitur-fitur SDK dapat diaktifkan. Kode berikut menunjukkan cara mendaftarkan SDK:

// Untuk versi 3.30.0 dan yang lebih baru:
NSError *error = [AliyunVideoSDKInfo registerSDK]; // Jika error yang dikembalikan bernilai nil, pendaftaran berhasil.
// Kegagalan pendaftaran biasanya disebabkan oleh kesalahan integrasi. Tambahkan pernyataan Assert untuk menampilkan error dan saran perbaikan selama integrasi dan debugging.
NSAssert2(error == nil, @"Gagal mendaftarkan SDK! %@; %@", error.localizedDescription, error.localizedRecoverySuggestion);

// Untuk versi 3.29.0:
// Ubah nama LicenseFile yang diperoleh menjadi license.crt. Tambahkan file tersebut ke proyek aplikasi Anda. Lalu, gunakan metode berikut untuk mendapatkan path LicenseFile.
NSString *licenseFilePath = [NSBundle.mainBundle pathForResource:@"license" ofType:@"crt"];
// Gunakan LicenseKey dan LicenseFilePath yang diperoleh untuk mendaftarkan SDK.
[AliyunVideoSDKInfo registerSDKWithLicenseKey:LicenseKey licenseFile:licenseFilePath];

Penting

Pendaftaran yang berhasil berarti lisensi telah dimuat ke dalam SDK, tetapi tidak menjamin bahwa otentikasi berhasil.

Kueri status lisensi saat ini dengan kode berikut.

AliyunVideoLicense *license = AliyunVideoLicenseManager.CurrentLicense;

SDK melakukan otentikasi saat Anda menggunakan fitur tertentu atau layanan bernilai tambah. Jika otentikasi gagal, pemanggilan API terkait akan mengembalikan hasil kegagalan. Anda juga dapat mendengarkan hasil otentikasi dari lokasi pusat.

// Untuk versi 3.30.0 dan yang lebih baru
AliyunVideoLicenseManager.EventDelegate = self; // Untuk informasi selengkapnya, lihat deskripsi protokol AliyunVideoLicenseEventDelegate.

Lakukan kueri proaktif terhadap hasil otentikasi dengan kode berikut.

AliyunVideoLicenseResultCode code = [AliyunVideoLicenseManager check];

Jika Anda memperpanjang subscription atau membeli layanan bernilai tambah, Anda dapat memperbarui lisensi secara manual. Secara default, SDK memeriksa pembaruan setiap 15 menit.

[AliyunVideoLicenseManager Refresh:^(AliyunVideoLicenseRefreshCode code){
    // Hasil pembaruan: code
}];

Tetapkan path impor bundle resource

Jika Anda mengintegrasikan SDK video pendek menggunakan CocoaPods dengan dependensi minimum, Anda mungkin perlu mengimpor bundle resource AliyunVideoSDKPro.bundle. Untuk mengurangi ukuran paket aplikasi, konfigurasikan aplikasi agar mengunduh bundle resource tersebut pada waktu proses. Setelah pengunduhan selesai, tetapkan path bundle agar tersedia untuk SDK.

Unggah bundle resource ke penyimpanan cloud Anda, seperti Object Storage Service (OSS).
Saat aplikasi dimulai, periksa keberadaan bundle resource. Jika bundle belum ada, unduh ke perangkat lokal Anda.
Setelah bundle resource diunduh atau jika sudah tersedia secara lokal, tetapkan path impor bundle resource di SDK video pendek sebagai berikut:
```
[AliyunVideoSDKInfo setSDKBundlePath:@"Path penyimpanan lokal bundle resource"];
```

Output log

Secara default, SDK video pendek hanya mengeluarkan log peringatan dan error (AlivcLogWarn). Atur tingkat log untuk mencetak log yang lebih detail guna keperluan troubleshooting.

// Tingkat log didefinisikan sebagai berikut:
typedef NS_ENUM(NSInteger, AlivcLogLevel)
{
    AlivcLogClose = 1,
    AlivcLogVerbose,
    AlivcLogDebug,
    AlivcLogInfo,
    AlivcLogWarn,
    AlivcLogError,
    AlivcLogFatal
};
// Tetapkan tingkat output log
[AliyunVideoSDKInfo setLogLevel:AlivcLogDebug];

Informasi versi

Cetak informasi versi untuk memastikan versi SDK yang benar telah diimpor atau untuk membantu troubleshooting:

[AliyunVideoSDKInfo printSDKInfo];

Anda juga dapat mencetak bidang tertentu:

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