iOS - Media Player framework

The iOS Media Player framework allows access to the native media player included with iOS. Datazoom’s framework facilitates native iOS applications to send video playback events based on the configuration created in data pipes.

1. Login to Datazoom here:  https://app.datazoom.io
   
2. Add a Collector as indicated here:  How to add a Collector
   
   
3. Copy the config key that was created at the end of the process
   Click the icon indicated below to copy the Configuration Key
   
   You will see this message:
   

     4. Replace the <configuration id from Datazoom> in Datazoom's  DZNativeCollector.framework file with the Key you copied above.

     5. Replace the <url given by Datazoom> with <https://platform.datazoom.io/beacon/v1/>

     6. Replace the <AVPlayer Object> with your playerInstance identifier

Initial setup

• Download DZ_Collector_iOS.xcframework file from here.

• Drag and drop the downloaded frameworks into your Xcode project. Drag the file to the files inspector on the left side of Xcode. Make sure you check the box "Copy items" in the popup menu that displays while drag and drop the file.

• In selected Xcode target, go to the General tab and scroll down to Frameworks, Libraries and Embedded Content (Embedded Binaries in older Xcode versions). Make sure that the framework added in the above step is present. If not present, add the framework by clicking the "+" button available at the same section. Also, make sure that Embed option is set to Embed & Sign.

Steps for Swift Language based Applications

• After including the framework file, open the ViewController/View file, where the AVPlayer(native player) is included.

• Import the framework using the following command:

import DZ_Collector_iOS

• Initialize the framework by passing along the 'Configuration ID', and URL given by Datazoom. Completion handler will return two values, success and error if happened.

let collector = DZ_Collector_iOS(configID: <configuration id from Datazoom>, url: <url given by Datazoom>, completion: @escaping (Bool, Error?) -> ())

• You can start recording events for your AVPlayer instance using this API call. 

collector.startRecordingEvents(for: <AVPlayer object>)

• You can also stop recording events of your AVPlayer instance using similar API call. 

collector.stopRecordingEvents(for: <AVPlayer object>)

• Run the app and observe the events captured in a Collector, data corresponding to MOBILE/iPhone in Platform, refers to the events tracked from iPhone.

Steps for ObjectiveC Language based Applications:

• After including the framework file, Create a bridging header file, to allow interoperability of languages.

• open the ViewController/View file, where the AVPlayer(native player) is included.

• Import the following:

#import <AVKit/AVKit.h> 
#import <AVFoundation/AVFoundation.h> 
#import <DZ_Collector_iOS/DZ_Collector_iOS.h>

• Initialize the swift class in the .h file.

DZ_Collector_iOS *collector;

• In the .m file, allocate using:

collector = [[DZ_Collector_iOS alloc]initWithConfigId: <configuration id from Datazoom>, url: <>]; 
[collector startWithCompletion: ^(BOOL result, NSError *error) {
    ...
}];

• Run the app and observe the events captured in a Collector, data corresponding to MOBILE/iPhone in Platform, refers to the events tracked from iPhone.

Demo Application

• A demo application that shows the usage of this framework is available Here.  This can be used to test the DZ_Collector_iOS framework.