Overview

An SMPushClient provides a high level interface to interacting with StackMob’s push service. A new client must be given an API Version and OAuth credentials in order to communicate with your StackMob application.

SMPushClient sets default values for other configuration settings which may be set as necessary by your application.

SMPushClient exposes a defaultClient for applications which use a globally available client to share configuration settings.

Include #import "StackMobPush.h" in your application files to gain access to SMPushClient and SMPushToken methods.

Setting Up A Basic Push Application

Upload your certs to StackMob

You can do this by reading through the Push API tutorial on StackMob.

Get a device token and initialize your push client

Set up an iOS app to register for remote notifications by calling registerForRemoteNotificationTypes when your app launches, most likely in application:didFinishLaunchingWithOptions:. Also initialize a push client.

// In application:didFinishLaunchingWithOptions:

// Assuming you declared the variable `SMPushClient *pushclient;`
// Public and private keys refer to your StackMob app's credentials.  Get them from the __Manage App Info__ link in the left column on the Dashboard
pushClient = [[SMPushClient alloc] initWithAPIVersion:@"0" publicKey:@"publicKey" privateKey:@"privateKey"];

[[UIApplication sharedApplication] registerForRemoteNotificationTypes:
    (UIRemoteNotificationTypeAlert | UIRemoteNotificationTypeBadge | UIRemoteNotificationTypeSound)];

Next, implement the method application:didRegisterForRemoteNotificationsWithDeviceToken: which will be called when your app successfully registers with APNS.

- (void)application:(UIApplication *)app didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
    NSString *token = [[deviceToken description] stringByTrimmingCharactersInSet:[NSCharacterSet characterSetWithCharactersInString:@"<>"]];
    token = [[token componentsSeparatedByString:@" "] componentsJoinedByString:@""];
    // Persist your user's accessToken here if you need

    // the user parameter is simply an arbitrary string to help you map a name to the device token
    [pushClient registerDeviceToken:token withUser:@"randomuser" onSuccess:createdSuccessBlock onFailure:createdFailureBlock];
}

Send push messages

You are now ready to broadcast messages! You can use any of the following methods to send push notifications:

• broadcastMessage:onSuccess:onFailure:
• sendMessage:toUsers:onSuccess:onFailure:
• sendMessage:toTokens:onSuccess:onFailure: