iOS のセットアップ set-up-ios

ダウンロードしたメディア SDK をプロジェクトに追加します。

1. libs ディレクトリに以下のソフトウェアコンポーネントが存在することを確認します。

   • ADBMediaHeartbeat.h：iOS ハートビートトラッキング API で使用される Objective-C ヘッダーファイル。

   • ADBMediaHeartbeatConfig.h：SDK 設定用の Objective-C ヘッダーファイル。

   • MediaSDK.a：iOS デバイス用のライブラリビルド（armv7、armv7s、arm64）とシミュレーター（i386 および x86_64）を含む、ビットコード対応の大きなバイナリ。

     ターゲットが iOS アプリを対象としている場合は、このバイナリがリンクされている必要があります。

   • MediaSDK_TV.a：新しい Apple TV デバイス用のライブラリビルド（arm64）とシミュレーター（x86_64）を含む、ビットコード対応の大きなバイナリ。

     このバイナリは、ターゲットが Apple TV（tvOS）アプリを対象としている場合、リンクされている必要があります。

2. 以下のようにして、プロジェクトにライブラリを追加します。

   1. Xcode IDE を起動して、アプリを開きます。

   2. Project Navigator で、libs ディレクトリをドラッグして、プロジェクトにドロップします。

   3. 「Copy Items if Needed」チェックボックスが選択されていること、「Create Groups」が選択されていること、および「Add to Target」にあるチェックボックスが選択されていないことを確認します。

   

   1. 「完了」をクリックします。

   2. Project Navigator で、アプリを選択し、ターゲットを選択します。

   3. 「一般」タブの「リンクされたフレームワーク」および「ライブラリ」セクションで、必要なフレームワークとライブラリをリンクさせます。

      iOS アプリのターゲット：

      • AdobeMobileLibrary.a
      • MediaSDK.a
      • libsqlite3.0.tbd

      Apple TV（tvOS）のターゲット：

      • AdobeMobileLibrary_TV.a
      • MediaSDK_TV.a
      • libsqlite3.0.tbd
      • SystemConfiguration.framework

   4. アプリケーションがエラーなくビルドされることを確認します。

ライブラリをインポートします。

#import "ADBMediaHeartbeat.h"
#import "ADBMediaHeartbeatConfig.h"

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

ここでは、MediaHeartbeat 設定パラメーターと、正確な追跡のために MediaHeartbeat インスタンスに正しい設定値を設定する方法を説明します。

ADBMediaHeartbeatConfig 初期化のサンプル：

// Media Heartbeat Initialization
ADBMediaHeartbeatConfig *config = [[ADBMediaHeartbeatConfig alloc] init];
config.trackingServer = <SAMPLE_HEARTBEAT_TRACKING_SERVER>;
config.channel        = <SAMPLE_HEARTBEAT_CHANNEL>;
config.appVersion     = <SAMPLE_HEARTBEAT_SDK_VERSION>;
config.ovp            = <SAMPLE_HEARTBEAT_OVP_NAME>;
config.playerName     = <SAMPLE_PLAYER_NAME>;
config.ssl            = <YES/NO>;
config.debugLogging   = <YES/NO>;

ADBMediaHeartbeatDelegate プロトコルを実装します。

@interface VideoAnalyticsProvider : NSObject <ADBMediaHeartbeatDelegate>

@end

@implementation VideoAnalyticsProvider

// Replace <bitrate>, <startuptime>, <fps> and <droppeFrames>
// with the current playback QoS values.
- (ADBMediaObject *)getQoSObject {
    return [ADBMediaHeartbeat createQoSObjectWithBitrate:<bitrate>
                              startupTime:<startuptime>
                              fps:<fps>
                              droppedFrames:<droppedFrames>];
}

// Return the current video player playhead position.
// Replace <currentPlaybackTime> with the video player current playback time
- (NSTimeInterval)getCurrentPlaybackTime {
    return <currentPlaybackTime>;
}

@end

ADBMediaHeartBeatConfig および ADBMediaHeartBeatDelegate を使用して、ADBMediaHeartbeat インスタンスを作成します。

//Replace <ADBMediaHeartBeatDelegate> with your delegate instance
_mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate:
  <ADBMediaHeartBeatDelegate> config:config];

プロジェクトの lib フォルダーに VideoHeartbeat_TV.a ライブラリファイルをドラッグします。

tvOS アプリのターゲットの「Build Phases（ビルドフェーズ）」タブで、「Link Binary with Libraries（バイナリをライブラリとリンク）」を展開して、以下のライブラリを追加します。

• MediaSDK_TV.a
• AdobeMobileLibrary_TV.a
• libsqlite3.0.tbd
• SystemConfiguration.framework