Objective-C SDK¶

Call Methods¶

The Objective-C SDK implements the Dailymotion Graph API using the Advanced API protocol. For a list of all available methods, see API Reference. To call a method using the Objective-C SDK, use the request:delegate: method as follow:

dailymotion = [[Dailymotion alloc] init];
[dailymotion request:@"/videos"
       withArguments:[NSDictionary dictionaryWithObjectsAndKeys:
                      [NSArray arrayWithObjects:@"id", @"title"], @"fields", nil]
            delegate:self];

To get the result, you have to implement the dailymotion:didReturnResult:userInfo: delegate method as follow:

- (void)dailymotion:(Dailymotion *)dailymotion didReturnResult:(NSDictionary *)result userInfo:(NSDictionary *)userInfo
{
    NSArray *videos = [result objectForKey:@"list"];
}

If an error occurs, the dailymotion:didReturnError:userInfo: delegate method is called.

- (void)dailymotion:(Dailymotion *)dailymotion didReturnError:(NSError *)error userInfo:(NSDictionary *)userInfo;
{
    [[[[UIAlertView alloc] initWithTitle:@"Error"
                                 message:[error.localizedDescription]
                                delegate:nil
                       cancelButtonTitle:@"Dismiss"
                       otherButtonTitles:nil] autorelease] show];

}

Authenticate¶

The Objective-C SDK implements three granting methods of OAuth 2.0: token, password and client_credentials.

dailymotion = [[Dailymotion alloc] init];
[dailymotion setGrantType:DailymotionGrantTypeToken
               withAPIKey:apiKey secret:apiSecret scope:@"read"];
[dailymotion request:uri withArguments:arguments delegate:self];

dailymotion = [[Dailymotion alloc] init];
NSDictionary *info = [NSDictionary dictionaryWithObjectsAndKeys:
                      kDMUsername, @"username", kDMPassword, @"password", nil];
[dailymotion setGrantType:DailymotionGrantTypePassword
               withAPIKey:apiKey secret:apiSecret scope:@"read"
                     info:info];
[dailymotion request:uri withArguments:arguments delegate:self];

dailymotion = [[Dailymotion alloc] init];
[dailymotion setGrantType:DailymotionGrantTypeClientCredentials
               withAPIKey:apiKey secret:apiSecret scope:@"read"];
[dailymotion request:uri withArguments:arguments delegate:self];

Upload File¶

Certain methods like POST /me/videos requires a URL to a file. To create those URLs, the uploadFile:delegate: method have to be used like this:

[dailymotion uploadFile:@"/path/to/file.mp4" delegate:self];

You have to implement the dailymotion:didUploadFileAtURL: delegate method to get the URL returned by the server. You can then use this URL as an argument to methods requiring such parameter. For instance to create a video:

- (void)dailymotion:(Dailymotion *)dailymotion didUploadFileAtURL:(NSString *)URL;
{
    [dailymotion request:@"POST /me/videos"
           withArguments:[NSDictionary dictionaryWithObject:URL forKey:@"url"]
                delegate:self];
}

In case of error, the dailymotion:didReturnError:userInfo: will be called. To implement progress indicator, you can implement the dailymotion:didSendFileData:totalBytesWritten:totalBytesExpectedToWrite: delegate method.

Player¶

To display a Dailymotion video in an iOS application (Mac OS X support under construction), the Dailymotion SDK provides the DailymotionPlayerViewController class. To instanciate a player controller, use the player: method:

DailymotionPlayerViewController *playerController [dailymotion player:@"xl2k3"];
playerController.delegate = self;

You can then call method, access properties and change some of them to control the playback of the video. The player return events using the dailymotionPlayer:didReceiveEvent: delegate method:

- (void)dailymotionPlayer:(DailymotionPlayerViewController *)player didReceiveEvent:(NSString *)eventName
{
    if ([eventName isEqualToString:@"timeupdate"])
    {
        progressBar.value = player.currentTime / player.duration;
    }
}