前提條件

初始化SDK前需要完成以下操作：
  • 獲取并開通短視頻SDK License，詳細內容請參見獲取短視頻SDK License。
  • 集成短視頻SDK。從3.29.0版本開始，注冊SDK之前，需要先配置License，詳細內容請參見集成SDK。

引入頭文件

SDK頭文件主要說明使用短視頻SDK時所需要遵循的接口使用規范，使用短視頻SDK前需要先引入頭文件。
  • 專業版&標準版
    #import <AliyunVideoSDKPro/AliyunVideoSDKPro.h>
  • 基礎版
    #import <AliyunVideoSDKBasic/AliyunVideoSDKBasic.h>

注冊SDK

從3.29.0版本開始，短視頻SDK升級了License服務，在App啟動后必須進行注冊，否則無法使用短視頻SDK的功能。具體如下：

// ≥ 3.30.0版本：
NSError *error = [AliyunVideoSDKInfo registerSDK]; // 返回error為nil表示注冊成功。
// 因為注冊失敗基本屬于接入錯誤，所以建議直接加上Assert就可以在接入調試時顯示錯誤和修復建議。
NSAssert2(error == nil, @"注冊SDK失敗！%@；%@", error.localizedDescription, error.localizedRecoverySuggestion);

// 3.29.0版本：
// 請把獲取到的LicenseFile改名為license.crt，加到您的App工程里，通過以下方式獲取LicenseFile路徑。
NSString *licenseFilePath = [NSBundle.mainBundle pathForResource:@"license" ofType:@"crt"];
// 使用獲取到的LicenseKey和LicenseFilePath注冊SDK。
[AliyunVideoSDKInfo registerSDKWithLicenseKey:LicenseKey licenseFile:licenseFilePath];
注意 注冊成功代表License已經注入到SDK內部，但是不代表鑒權結果成功。
您可以通過代碼查詢當前License狀態信息。
AliyunVideoLicense *license = AliyunVideoLicenseManager.CurrentLicense;
在您使用具體功能或增值服務時，SDK內部會發生鑒權，如果鑒權失敗會在對應的接口返回結果。您也可以在統一的地方監聽鑒權結果。
// ≥ 3.30.0版本
AliyunVideoLicenseManager.EventDelegate = self; // 具體請參考AliyunVideoLicenseEventDelegate協議說明
您可以通過代碼主動查詢鑒權結果。
AliyunVideoLicenseResultCode code = [AliyunVideoLicenseManager check];
如果您續費了或者購買了增值服務也可以主動更新License（默認每15分鐘檢查更新一次）。
[AliyunVideoLicenseManager Refresh:^(AliyunVideoLicenseRefreshCode code){
    // 更新結果: code
}];

設置資源包引入路徑

通過pod方式的最少依賴方式集成短視頻SDK時，如果需要引入資源包AliyunVideoSDKPro.bundle，且考慮到包大小問題，不想在工程中引入，那么可以通過以下方法，實現在APP運行時自動下載資源包，下載完成后引入到短視頻SDK中。

  1. 把資源包上傳到您的云空間上（例如OSS中）。
  2. 在APP啟動時進行資源包判定，如果資源包不存在則進行下載，將資源包下載到本地。
  3. 本地已存在資源包或資源包下載完成后，設置短視頻SDK引入資源包的路徑，方法如下：
    [AliyunVideoSDKInfo setSDKBundlePath:@"資源包的本地存儲路徑"];

日志輸出

默認情況下，短視頻SDK僅輸出警告和出錯日志（AlivcLogWarn）。用戶可以設置日志輸出級別以打印更多日志作為故障排查參考。
// 日志級別定義如下：
typedef NS_ENUM(NSInteger, AlivcLogLevel)
{
    AlivcLogClose = 1,
    AlivcLogVerbose,
    AlivcLogDebug,
    AlivcLogInfo,
    AlivcLogWarn,
    AlivcLogError,
    AlivcLogFatal
};
// 設置日志輸出級別
[AliyunVideoSDKInfo setLogLevel:AlivcLogDebug];

版本信息

您可以通過以下方式打印版本信息，以確保引入的SDK版本正確或幫助排查SDK使用過程中的問題。
[AliyunVideoSDKInfo printSDKInfo];
您還可以打印所需要的信息。
NSString *version = [AliyunVideoSDKInfo version]; // 版本號
NSString *module = [AliyunVideoSDKInfo module];   // 版本類型
int moduleCode =[AliyunVideoSDKInfo versionCode]; // 版本類型代碼
NSString *buildId =[AliyunVideoSDKInfo videoSDKBuildId]; // 版本打包ID
NSLog(@"\n==============\nVERSION：%@\nBUILD_ID：%@\nMODULE：%@\nMODULE_CODE：%d\n==============", version, buildId, module, moduleCode);