iOS でのコア再生の追跡 track-core-playback-on-ios

トラッキングの初期設定

いつユーザーが再生の意図をトリガーする（ユーザーが再生をクリックする、または自動再生がオンになる）かを識別し、MediaObject インスタンスを作成します。

createMediaObjectWithName API

StreamType定数：

MediaType定数：

MediaObject を作成するための一般的な形式：

ADBMediaObject *mediaObject =
  [ADBMediaHeartbeat createMediaObjectWithName:<MEDIA_NAME>
                                       mediaId:<MEDIA_ID>
                                        length:<MEDIA_LENGTH>
                                    streamType:<STREAM_TYPE>
                                     mediaType: <MEDIA_TYPE>];

ビデオメタデータのアタッチ

オプションで、コンテキストデータ変数を使用して標準またはカスタムのビデオメタデータオブジェクトをビデオトラッキングセッションにアタッチします。

• 標準のビデオメタデータ

  • iOS での標準メタデータの実装

  • ビデオのメタデータキー
    iOS のメタデータキー

  • ビデオメタデータの包括的なリストについては、オーディオおよびビデオパラメーターを参照してください。

  note note
  NOTE
  メディアオブジェクトへの標準のビデオメタデータオブジェクトのアタッチはオプションです。

• カスタムメタデータ

  カスタム変数の変数オブジェクトを作成し、このビデオのデータを設定します。次に例を示します。

  code language-none
  NSMutableDictionary *videoMetadata = [[NSMutableDictionary alloc] init]; [videoMetadata setObject:@"false" forKey:@"isUserLoggedIn"]; [videoMetadata setObject:@"Sample TV station" forKey:@"tvStation"];

意図を追跡して再生を開始

メディアセッションの追跡を開始するには、メディアハートビートインスタンスの trackSessionStart を呼び出します。

- (void)onMainVideoLoaded:(NSNotification *)notification {
//    [_mediaHeartbeat trackSessionStart:mediaObject data:nil];
    [_mediaHeartbeat trackSessionStart:mediaObject data:videoMetadata];
}

実際の再生開始を追跡

ビデオの再生開始（ビデオの最初のフレームが画面に表示）に関するイベントをビデオプレーヤーから識別し、trackPlay () を呼び出します。

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}

再生の完了を追跡

ビデオの再生完了（ユーザーがコンテンツを最後まで視聴）に関するイベントをビデオプレーヤーから識別し、trackComplete () を呼び出します。

- (void)onVideoComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackComplete];
}

セッションの終了を追跡

ビデオ再生のアンロード／終了（ユーザーがビデオを閉じる、またはビデオの再生が完了してアンロードされる）に関するイベントをビデオプレーヤーから識別し、trackSessionEnd () を呼び出します。

- void)onMainVideoUnloaded:(NSNotification *)notification {
    [_mediaHeartbeat trackSessionEnd];
}

考えられるすべての一時停止シナリオを追跡

ビデオの一時停止に関するイベントをビデオプレーヤーから識別し、trackPause を呼び出します。

- (void)onVideoPause:(NSNotification *)notification {
    [_mediaHeartbeat trackPause];
}

一時停止のシナリオ

ビデオプレーヤーが一時停止するあらゆるシナリオを識別して、trackPause が適切に呼び出されるようにします。以下のシナリオでは、アプリで trackPause() () を呼び出す必要があります。

• アプリ内でユーザーが明示的に一時停止をクリックする。
• プレーヤー自体が一時停止状態になる。
• （モバイルアプリケーション）- ユーザーがアプリケーションをバックグラウンドに移行した場合でも、アプリケーションのセッションを開いたままにしておきたい。
• （モバイルアプリケーション）- 何らかのシステムの割り込みが生じ、アプリケーションがバックグラウンドに移行する。例：ユーザーに電話がかかってきた場合や、別のアプリケーションのポップアップが表示された場合でも、アプリケーションのセッションを終了せず、ユーザーが中断した場所からビデオを再開できるようにしたい。

一時停止からのビデオ再生およびビデオ再開に関するイベントをプレーヤーから識別し、trackPlay を呼び出します。

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}