IOS分享SDK接入说明

1 接入指南

掌趣分享SDK是一个聚合SDK，目前整合了微信、QQ、新浪微博等SDK，包含文本分享、图片分享、链接分享等功能。本SDK最低支持ios6.0

2 工程配置

2.1 添加库、资源、配置文件

注意：prop.cfg由掌趣运营提供

2.2 配置Info.plist文件

  <key>LSApplicationQueriesSchemes</key>
  <array>
    <string>weixin</string>
    <string>mqq</string>
    <string>mqqapi</string>
    <string>mqqwpa</string>
    <string>mqqbrowser</string>
    <string>mttbrowser</string>
    <string>mqqOpensdkSSoLogin</string>
    <string>mqqopensdkapiV2</string>
    <string>mqqopensdkapiV3</string>
    <string>mqqopensdkapiV4</string>
    <string>wtloginmqq2</string>
    <string>mqzone</string>
    <string>mqzoneopensdk</string>
    <string>mqzoneopensdkapi</string>
    <string>mqzoneopensdkapi19</string>
    <string>mqzoneopensdkapiV2</string>
    <string>mqqopensdkfriend</string>
    <string>mqqopensdkdataline</string>
    <string>mqqgamebindinggroup</string>
    <string>mqqopensdkgrouptribeshare</string>
    <string>tencentapi.qq.reqContent</string>
    <string>tencentapi.qzone.reqContent</string>
    <string>tim</string>
    <string>timapi</string>
    <string>timopensdkfriend</string>
    <string>timwpa</string>
    <string>timgamebindinggroup</string>
    <string>timapiwallet</string>
    <string>timOpensdkSSoLogin</string>
    <string>wtlogintim</string>
    <string>timopensdkgrouptribeshare</string>
    <string>timopensdkapiV4</string>
    <string>timgamebindinggroup</string>
    <string>timopensdkdataline</string>
    <string>wtlogintimV1</string>
    <string>timapiV1</string>
    <string>sinaweibohd</string>
    <string>sinaweibo</string>
    <string>weibosdk</string>
    <string>weibosdk2.5</string>
  </array>

2.3 配置URL Scheme

  <key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLName</key>
      <string>tencent</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>tencent222222</string>    // tencent+appId
      </array>
    </dict>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLName</key>
      <string>com.weibo</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>wb2045436852</string>  // wb+appId
      </array>
    </dict>
  </array>

2.4 配置系统库

3 分享集成

功能说明
分享

接口定义

void ShareThirdPlatform( NSString* shareScene, 
                        NSDictionary* shareContent, 
                        void (* pfuncShare)(const char * shareType,int errCode,const char * jsonStr));

分享接口参数：

参数名	类型	重要性	说明
shareScene	NSString	（必填）	分享场景： SceneWeChat 微信好友 SceneWeChatLine 微信朋友圈 SceneQQ QQ好友 SceneQzone QQ空间 SceneSinaWeibo 新浪微博
shareContent	NSDictionary	（必填）	分享内容，具体根据分享类型的不同而不同
pfuncShare	void*	（必填）	分享回调

3.1 分享文本

参数名	类型	重要性	说明
OPSParam_ShareType	NSString	必填	OPShareText
OPSParam_Text	NSString	必填	文本内容

3.2 分享图片

参数名	类型	重要性	说明
OPSParam_ShareType	NSString	必填	OPShareImage
OPSParam_ImagePath	NSString	必填	本地图片路径

3.3 分享链接

参数名	类型	重要性	说明
OPSParam_ShareType	NSString	必填	OPShareLink
OPSParam_Text	NSString	必填	文本内容
OPSParam_ImagePath	NSString	必填	本地图片路径
OPSParam_LinkTitle	NSString	必填	链接标题
OPSParam_LinkDesc	NSString	必填	链接描述
OPSParam_LinkUrl	NSString	必填	链接地址

接口示例

// 回调函数
void ShareThirdPlatformCallBack(const char * shareType, int errCode, const char * jsonStr)
{
     NSLog(@"ShareThirdPlatformCallBack");
     string result = shareType;
     if (errCode == 1) {
          result.append("分享成功!");
     } else {
          result.append("分享失败!");
     }
     cout<<errCode<<endl;
     NSString *msg = [NSString stringWithUTF8String:result.c_str()];
     NSLog(@"%@", msg);
     UIAlertView*alert = [[UIAlertView alloc]initWithTitle:nil
                                                   message:msg
                                                  delegate:nil
                                         cancelButtonTitle:nil
                                         otherButtonTitles:@"确定",nil];
     [alert show];
}
 // *************************微信分享************************************
- (void)weChatShareScene:(int) friendScene contentType:(int) type
{
     NSMutableDictionary *dic = [[NSMutableDictionary alloc] init];
     if (type == 0) {
          //分享文本
          [dic setObject:OPShareText forKey:OPSParam_ShareType];
          [dic setObject:@"test" forKey:OPSParam_Text];
     }else if(type == 1){
          //分享图片
          NSString *filePath = [[NSBundle mainBundle] pathForResource:@"localPic" ofType:@"png"];
          [dic setObject:OPShareImage forKey:OPSParam_ShareType];
          [dic setObject:filePath forKey:OPSParam_ImagePath];
          //        [dic setObject:filePath forKey:@"thumbImage"];//缩略图
     }else{
          //分享链接
          NSString *filePath = [[NSBundle mainBundle] pathForResource:@"localPic" ofType:@"png"];
          [dic setObject:OPShareLink forKey:OPSParam_ShareType];
          [dic setObject:@"testTitle" forKey:OPSParam_LinkTitle];
          [dic setObject:@"http://www.ourpalm.com/" forKey:OPSParam_LinkUrl];
          [dic setObject:@"testDesc" forKey:OPSParam_LinkDesc];
          [dic setObject:filePath forKey:OPSParam_ImagePath];
     }
     if (friendScene == 0) {
          //好友分享
          OPGameSDK::GetInstance().ShareThirdPlatform(SceneWeChat, dic,ShareThirdPlatformCallBack);
     } else {
          //朋友圈分享
          OPGameSDK::GetInstance().ShareThirdPlatform(SceneWeChatLine, dic,ShareThirdPlatformCallBack);
     }
}
 // *************************QQ分享************************************
- (void)qqShareScene:(int)friendScene contentType:(int)type
{
     NSMutableDictionary *dic = [[NSMutableDictionary alloc] init];
     if (type == 0) {
          //分享文本
          [dic setObject:OPShareText forKey:OPSParam_ShareType];
          [dic setObject:@"文本测试" forKey:OPSParam_Text];
     }else if(type == 1){
          //分享图片
          NSString *filePath = [[NSBundle mainBundle] pathForResource:@"localPic" ofType:@"png"];
          [dic setObject:OPShareImage forKey:OPSParam_ShareType];
          [dic setObject:filePath forKey:OPSParam_ImagePath];
          //        [dic setObject:filePath forKey:@"thumbImage"];//缩略图
     }else{
          //分享链接
          NSString *filePath = [[NSBundle mainBundle] pathForResource:@"localPic" ofType:@"png"];
          [dic setObject:OPShareLink forKey:OPSParam_ShareType];
          [dic setObject:@"testTitle" forKey:OPSParam_LinkTitle];
          [dic setObject:@"http://www.ourpalm.com/" forKey:OPSParam_LinkUrl];
          [dic setObject:@"testDesc" forKey:OPSParam_LinkDesc];
          [dic setObject:filePath forKey:OPSParam_ImagePath];
     }
//     [dic setObject:@"NOAPPID" forKey:OPSParam_NOAPPID];
     if (friendScene == 0) {
          //好友分享
          OPGameSDK::GetInstance().ShareThirdPlatform(SceneQQ, dic,ShareThirdPlatformCallBack);
     } else {
          //空间分享
          OPGameSDK::GetInstance().ShareThirdPlatform(SceneQzone, dic,ShareThirdPlatformCallBack);
     }
}
//*************************微博分享************************************
- (void)weiboShareContentType:(int)type
{
     NSMutableDictionary *dic = [[NSMutableDictionary alloc] init];
     if (type == 0) {
          //分享文本
          [dic setObject:OPShareText forKey:OPSParam_ShareType];
          [dic setObject:@"文本测试" forKey:OPSParam_Text];
     } else if (type == 1) {
          //分享图片
          NSString *filePath = [[NSBundle mainBundle] pathForResource:@"localPic" ofType:@"png"];
          [dic setObject:OPShareImage forKey:OPSParam_ShareType];
          [dic setObject:filePath forKey:OPSParam_ImagePath];
     } else {
          //分享链接
          NSString *filePath = [[NSBundle mainBundle] pathForResource:@"thumbImage" ofType:@"jpg"];
          [dic setObject:OPShareLink forKey:OPSParam_ShareType];
          [dic setObject:@"testTitle" forKey:OPSParam_LinkTitle];
          [dic setObject:@"http://www.sadfsadfsaf.com/" forKey:OPSParam_LinkUrl];
          [dic setObject:@"testDesc" forKey:OPSParam_LinkDesc];
          [dic setObject:filePath forKey:OPSParam_ImagePath];
          //        [dic setObject:filePath forKey:@"thumbImage"];      //多媒体内容中缩略图大小不能大于32K
     }
     OPGameSDK::GetInstance().ShareThirdPlatform(SceneSinaWeibo, dic,ShareThirdPlatformCallBack);
}

4、参数规则限制介绍

4.1、新浪微博分享规则

（1）新浪微博支持分享类型：
a、应用内分享也就是网页分享支持：文字，文字+图片，要分享链接需要链接添加在text里分享
b、客户端分享支持：文字，图片，文字+图片，图片+文字+链接

参数说明：
text：不能超过140个汉字
image：图片最大不超过5M，仅支持PNG格式

4.2、QQ好友分享规则

QQ好友分享支持：文字，图片，文字+图片+链接，音乐链接，视频链接

参数说明：
text：最多40个字符
title：最多30个字符，超出部分会被截断
url ：URL 地址，最长 512 个字符
thumbImage：预览图数据，最大20k
image：最大1M，仅支持PNG格式

4.3、QQ空间分享规则

QQ空间分享支持：文字，图片，文字+图片+链接，本地视频，视频链接

参数说明：
url: 1、必须用域名网址； 2、url 不能含有中文；
title：最多200个字符；
text：最多600个字符；

4.4、微信（好友、朋友圈、收藏）分享规则

微信好友分享支持：文字，图片，文字+图片+链接，音乐链接，视频链接，应用消息，表情，文件（本地视频），小程序
微信朋友圈分享支持：文字，图片，文字+图片+链接，音乐链接，视频链接
微信收藏分享支持：文字，图片，文字+图片+链接，音乐链接，视频链接，文件（本地视频）

参数说明
title：512Bytes以内
description：1KB以内
imageData：大小不能超过5M
imagePath：大小不能超过5M(传递的imagePath路径不能超过10KB)
imageUrl：长度不能超过10K（图片链接，仅支持PNG格式，较好的效果为大图360x200，小图200x200 ）
ThumbImage：内存大小不能超过32K的png图，图片分享必须添加此图！！！！
musicUrl：长度不能超过10K
videoUrl：长度不能超过10K
url：不能为空且长度不能超过10K

Table of Contents