Discussion

Retrieve the current user’s social network access token object as NSDictionary. If the user is not associated with the specified provider, returns nil. The dictionary would be cached after the login and link has been executed. Cache would be cleared when new login, link or unlink has been executed. (Regardless of same/different KiiConnectorProvider is specified)

Please keep the returned value in your application program before execute new login/ link session when you sequencially link the several social network providers with the same user if you need to use them. Following parameters can be assigned to NSDictionary’s key.

Discussion

Retrieve the current user’s access token object by NSDictionary from a social network

The network must be set up and linked to the current user. It is recommended you save this to preferences for multi-session use. Following parameters can be assigned to NSDictionary’s key.

Facebook

Twitter

QQ

Kii Social Network Connect

Discussion

Retrieve the current user’s access token expiration date from a social network

The network must be set up and linked to the current user. It is recommended you save this to preferences for multi-session use.

Discussion

Retrieve the current user’s access token from a social network

The network must be set up and linked to the current user. It is recommended you save this to preferences for multi-session use.

Discussion

Required method by KiiSocialNetwork

This method must be placed in your AppDelegate file in order for the SNS to properly authenticate with KiiSocialConnect:

// Pre iOS 4.2 support
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {
    return [KiiSocialConnect handleOpenURL:url];
}

// For iOS 4.2+ support
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
                                       sourceApplication:(NSString *)sourceApplication
                                              annotation:(id)annotation {
    return [KiiSocialConnect handleOpenURL:url];
}

Discussion

Link the currently logged in user with supported social networks (Facebook, Twitter, Renren, Google and QQ).

The provider should be valid KiiConnectorProvider values. Otherwise, an exception will be raised.
Snippet for link with social network:

[KiiSocialConnect linkCurrentUser:kiiConnectorFacebook
                          options:@{@"accessToken":@"access_token"}
                            block:^(KiiUser *user, KiiConnectorProvider provider, NSError *error) {
    if (error == nil) {
        // link successful. Do someting with the user.
    } else {
        // something went wrong.
    }
}];

Following parameters can be assigned to NSDictionary’s key.

Facebook, Renren, GooglePlus

Twitter

QQ

Discussion

Login with specified social network.

Note: Login with UI provided by SDK will be not supported after July 31st, 2019.

This will initiate the login process for the given network, with or without UI handled by SDK. If you prefer to handle login UI or using provider specific SDK to obtain access token, pass required params (acces token, access token secret, open ID) according to each provider. Other than kiiConnectorQQ, Kii SDK can handle the UI by passing nil into the options. If the social network user has already linked with a KiiUser, that user will be used as signed user. Otherwise, KiiCloud creates a new user and link with the specified social network account. The provider should be valid KiiConnectorProvider values. Otherwise, an exception will be raised.
Snippet for Login with social network without UI:

[KiiSocialConnect logIn:kiiConnectorFacebook
                options:@{@"accessToken":@"access_token"}
                  block:^(KiiUser *user, KiiConnectorProvider provider, NSError *error) {
    if (error == nil) {
        // link successful. Do someting with the user.
    } else {
        // something went wrong.
    }
}];

Snippet for Login with social network with UI:

[KiiSocialConnect logIn:kiiConnectorFacebook
                options:nil
                  block:^(KiiUser *user, KiiConnectorProvider provider, NSError *error) {
    if (error == nil) {
        // link successful. Do someting with the user.
    } else {
        // something went wrong.
    }
}];

Following parameters can be assigned to NSDictionary’s key.

Facebook, Renren, Googleplus

Twitter

QQ

Discussion

Get UINavigationController for login with specified social network.

Note: Login with UI provided by SDK will be not supported after July 31st, 2019.

This will initiate the login process for the given network, with or without UI handled by SDK. If you prefer to handle login UI or using provider specific SDK to obtain access token, pass required params (acces token, access token secret, open ID) according to each provider. Other than kiiConnectorQQ, Kii SDK can handle the UI by passing nil into the options. If the social network user has already linked with a KiiUser, that user will be used as signed user. Otherwise, KiiCloud creates a new user and link with the specified social network account. The provider should be valid KiiConnectorProvider values. Otherwise, an exception will be raised.
Snippet for Login with social network without UI:

UINavigationController nc = [KiiSocialConnect logInNavigationController:kiiConnectorFacebook block:^(KiiUser user, KiiConnectorProvider provider, NSError *error) { if (error == nil) { // link successful. Do someting with the user. } else { // something went wrong. } }]; [{instance of top view controoler} presentViewController:nc animated:YES completion:nil];

Discussion

Set up a reference to one of the supported KiiSocialNetworks.

The user will not be authenticated or linked to a KiiUser until one of those methods are called explicitly.

Discussion

Unlink the currently logged in user from the social network.

The provider should be valid KiiConnectorProvider values. Otherwise, an exception will be raised.

Snippet for unlink current user with network. :

[KiiSocialConnect unLinkCurrentUser:kiiConnectorFacebook
                              block:^(KiiUser *user, KiiConnectorProvider name, NSError *error) {
    if (error == nil) {
        // unlink successful.
    } else {
        // something went wrong.
    }
}];