スタートガイド - ApsaraVideo VOD - Alibaba Cloud ドキュメントセンター

このトピックでは、ApsaraVideo Player SDK for iOS を使用してビデオ再生を開始する方法について説明します。

前提条件

ApsaraVideo Player SDK for iOS を統合している必要があります。詳細については、「SDK の統合」をご参照ください。

オープンソースのデモプロジェクト

コード例の詳細については、API-Example の BasicPlayback モジュールをご参照ください。この Objective-C デモプロジェクトは、ApsaraVideo Player SDK for iOS の使用方法を示し、開発者が SDK のコア機能を迅速に統合するのに役立ちます。

手順

ステップ 1: プレーヤーの作成

AliPlayer インスタンスを作成します。

// プレーヤーインスタンスを作成します。
AliPlayer mAliPlayer = [[AliPlayer alloc] init];

// ビデオを表示するためのビューコンテナーを作成し、プレーヤーのレンダリングビューを設定します。
UIView playerView = [[UIView alloc] initWithFrame:self.view.bounds];
[self.view addSubview:playerView];
mAliPlayer.playerView = playerView;

[mAliPlayer setTraceID:traceId];

説明

プレーヤーの再生品質モニタリング、シングルポイントトラッキング、およびビデオ再生統計機能はすべて、イベントトラッキングログレポート機能に依存します。再生品質モニタリングを使用すると、全体的な再生品質に関するデータを表示できます。シングルポイントトラッキングを使用すると、特定のユーザーまたはデバイスを特定し、その再生動作を分析し、再生の問題を迅速に特定できます。

プレーヤーを作成する際、利用可能な機能は setTraceID パラメーターの設定によって異なります。詳細は以下の通りです。

setTraceID パラメーターを渡さない場合 (デフォルト): イベントトラッキングログレポート機能が有効になります。再生品質モニタリング機能とビデオ再生統計機能を使用できます。シングルポイントトラッキング機能は使用できません。
traceid を setTraceID パラメーターに渡す場合: traceid は、ビジネスのユーザー ID、国際移動体装置識別番号 (IMEI)、広告主識別子 (IDFA) など、ユーザーまたはユーザーのデバイスの一意の識別子でなければならないカスタム値です。 traceid を渡すと、イベントトラッキングログレポート機能が有効になります。これにより、再生品質モニタリング、シングルポイントトラッキング、およびビデオ再生統計機能を使用できます。
setTraceID パラメーターを DisableAnalytics に設定した場合: イベントトラッキングログレポート機能は無効になります。再生品質モニタリング、シングルポイントトラッキング、ビデオ再生統計機能は使用できません。

ステップ 2: 再生ソースの設定

VidAuth を使用した再生 (推奨)

AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
authSource.vid = @"Video ID"; // 必須。 ビデオ ID。
authSource.playAuth = @"<yourPlayAuth>"; // 必須。 再生認証情報。 ApsaraVideo VOD の GetVideoPlayAuth 操作を呼び出して、認証情報を生成する必要があります。
authSource.region = @"Region"; // ApsaraVideo Player SDK V5.5.5.0 以降では、このパラメーターは非推奨です。 プレーヤーが自動的にリージョンを解析するため、リージョンを設定する必要はありません。 V5.5.5.0 より前のバージョンでは、このパラメーターは必須です。 ApsaraVideo VOD がアクティブ化されているリージョンを指定します。 デフォルト値: cn-shanghai。
// authSource.authTimeout = 3600; // 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定されている URL 署名の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値の 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL の有効期限が切れないように、実際のビデオの長さを超える値を設定してください。

// 再生ソースを設定します。
[mAliPlayer setAuthSource:authSource];

VidSts を使用した再生

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.vid = @"Video ID"; // 必須。 ビデオ ID。
source.region = @"Region"; // 必須。 ApsaraVideo VOD がアクティブ化されているリージョン。 デフォルト値: cn-shanghai。
source.securityToken = @"<yourSecurityToken>"; // 必須。 セキュリティトークンサービス (STS) トークン。 STS の AssumeRole 操作を呼び出してトークンを生成する必要があります。
source.accessKeySecret = @"<yourAccessKeySecret>"; // 必須。 一時的な AccessKey ペアの AccessKey Secret。 STS の AssumeRole 操作を呼び出してシークレットを生成する必要があります。
source.accessKeyId = @"<yourAccessKeyId>"; // 必須。 一時的な AccessKey ペアの AccessKey ID。 STS の AssumeRole 操作を呼び出して ID を生成する必要があります。
// source.authTimeout = 3600; // 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定されている URL 署名の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値の 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL の有効期限が切れないように、実際のビデオの長さを超える値を設定してください。
// ApsaraVideo VOD コンソールで HLS 暗号化パラメーターのパススルーを有効にし、デフォルトのパラメーター名が MtsHlsUriToken の場合は、config を設定して vid に渡す必要があります。

// 再生ソースを設定します。
[mAliPlayer setStsSource:source]

UrlSource を使用した再生

// 再生ソースオブジェクトを作成し、再生 URL を設定します。
// 再生 URL は、サードパーティのビデオオンデマンド (VOD) URL、ApsaraVideo VOD の再生 URL、またはローカルビデオ URL にすることができます。
AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:@"Playback URL"];
[mAliPlayer setUrlSource:urlSource];

説明

再生ソースの設定方法の詳細については、「基本機能」をご参照ください。

ステップ 3: 再生の開始

// 再生を準備します。
[mAliPlayer prepare];
// prepare が呼び出された後、start 操作を同期的に呼び出すことができます。 onPrepared コールバックが完了すると、再生が自動的に開始されます。
[mAliPlayer start];

ステップ 4: 再生の停止

// 再生を停止します。
[mAliPlayer stop];
// リソースを同期的に解放します。 stop メソッドは自動的に呼び出されます。
[mAliPlayer destroy];
// メモリリークを防ぐために参照をクリアします。
mAliPlayer = nil;

リファレンス

再生コントロールやイベントリスナーなどの基本的なプレーヤー機能の詳細については、「基本機能」をご参照ください。