Set up iOS set-up-ios

Add your downloaded Media SDK to your project.

1. Verify that the following software components exist in the libs directory:

   • ADBMediaHeartbeat.h: The Objective-C header file that is used for iOS heartbeat tracking APIs.

   • ADBMediaHeartbeatConfig.h: The Objective-C header file for the SDK configuration.

   • MediaSDK.a: A bitcode-enabled fat binary that contains the library builds for iOS devices (armv7, armv7s, arm64) and simulators (i386 and x86_64).

     This binary should be linked when the target is intended for an iOS app.

   • MediaSDK_TV.a: A bitcode-enabled fat binary containing the library builds for new Apple TV devices (arm64) and simulator (x86_64).

     This binary should be linked when the target is intended for an Apple TV (tvOS) app.

2. Add the library to your project:

   1. Launch the Xcode IDE and open your app.

   2. In Project Navigator, drag the libs directory and drop it under your project.

   3. Ensure that the Copy Items if Needed checkbox is selected, the Create Groups is selected, and none of the checkboxes in Add to Target are selected.

   

   1. Click Finish.

   2. In Project Navigator, select your app and select your targets.

   3. Link the required frameworks and libraries in the Linked Frameworks and Libraries section on the General tab.

      iOS App Targets:

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

      Apple TV (tvOS) Targets:

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

   4. Verify that your app builds without errors.

Import the library.

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

Create a ADBMediaHeartbeatConfig instance.

This section helps you to understand the MediaHeartbeat config parameters, and to set correct config values on your MediaHeartbeat instance for accurate tracking.

Here is a sample ADBMediaHeartbeatConfig initialization:

// 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>;

Implement the ADBMediaHeartbeatDelegate protocol.

@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

Use the ADBMediaHeartBeatConfig and ADBMediaHeartBeatDelegate to create the ADBMediaHeartbeat instance.

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

Drag the VideoHeartbeat_TV.a library file into your project’s lib folder.

In the Build Phases tab of your tvOS app’s target, expand the Link Binary with Libraries section and add the following libraries:

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