iosPlatform

iOS微信分享

2018-09-04  本文已影响1374人  Geniune

微信开发平台:https://open.weixin.qq.com
iOS Demo:https://github.com/Geniune/WXApi (记得给个star哦)

微信分享功能支持以下六种类型:

  1. 文字类型
  2. 图片类型
  3. 音乐类型
  4. 视频类型
  5. 网页类型
  6. 小程序类型

主要描述网页类型和小程序类型

目标场景有三个,通过SendMessageToWXReq的scene属性区分:

  1. WXSceneSession 分享到消息会话
  2. WXSceneTimeline 分享到朋友圈
  3. WXSceneFavorite 添加到收藏

1.网页类型分享

网页类型分享是平时使用频率最高的功能,其内容包括:标题+描述+缩略图+点击跳转的URL链接。
如图所示京东的商品分享:


微信分享截图.png

分享示例代码:

if([WXApi isWXAppInstalled]){//判断当前设备是否安装微信客户端

    //创建多媒体消息结构体
    WXMediaMessage *message = [WXMediaMessage message];
    message.title = @"【爆款直降 盛夏特惠】【29.9免邮 限量买3免1】清新持久自然GUCCMI香水";//标题
    message.description = @"我在京东发现了一个不错的商品,赶快来看看吧。";//描述
    [message setThumbImage:[UIImage imageNamed:@"res2.png"]];//设置预览图

    //创建网页数据对象
    WXWebpageObject *webObj = [WXWebpageObject object];
    webObj.webpageUrl = @"[https://open.weixin.qq.com](https://open.weixin.qq.com)";//链接
    message.mediaObject = webObj;

    SendMessageToWXReq *sendReq = [[SendMessageToWXReq alloc] init];
    sendReq.bText = NO;//不使用文本信息
    sendReq.message = message;
    sendReq.scene = WXSceneSession;//分享到好友会话

    [WXApi sendReq:sendReq];//发送对象实例
}else{

    //未安装微信应用或版本过低
}
//分享回调
- (void)onResp:(id)resp{

    if([resp isKindOfClass:[SendMessageToWXResp class]]){
        
        SendMessageToWXResp *req = (SendMessageToWXResp *)resp;
        //这里不再返回用户是否分享完成事件,即原先的cancel事件和success事件将统一为success事件
//        if(req.errCode == 0){
//            //分享成功
//        }
    }
}

实际使用过程中有几个点需要注意:
1、很多时候分享所需数据需要通过http请求或和html交互等方式获得,而这个过程又是异步的,在发起微信分享时请保证在主线程上操作;
2、微信SDK要求分享图片大小不得超过32K,否则会导致分享失败并且还TMD没任何提示(身边很多小伙伴被这个坑过)。而通常开发过程中能获得的仅为一个URL,像素和图片文件大小不得而知,我的解决办法是先对图片进行裁剪,再压缩,代码如下:

- (UIImage *)imageWithImage:(UIImage*)image scaledToSize:(CGSize)newSize{
    
    UIGraphicsBeginImageContext(newSize);
    [image drawInRect:CGRectMake(0,0,newSize.width,newSize.height)];//根据newSize对图片进行裁剪
    UIImage* newImage = UIGraphicsGetImageFromCurrentImageContext();
    UIGraphicsEndImageContext();
    return [UIImage imageWithData:UIImageJPEGRepresentation(newImage, 0.5)];//压缩50%
}

更新于(2018年8月30日)
最近同事发现个问题,就是无论如何操作,返回结果都是分享成功(即使取消分享也一样)
后来经过查看开放平台调整通知,才知道人家微信团队已经修改过了,具体调整如下:

分享功能调整.png

重点:分享接口调用后,不再返回用户是否分享完成事件,即原先的cancel事件和success事件将统一为success事件。

2.小程序类型分享

更新于(2019年2月20日)

在开发前,需要做的准备工作:

  1. 更新WeChatSDK也就是开发者工具包至最新版本,1.7.7以前的版本不能分享小程序
  2. 申请对应的小程序账号并审核通过,并且保证原生App和小程序属于同一个微信开发平台账号(重要!!)
  3. 其他类型不同,小程序类型只支持分享至消息会话,scene属性只能使用WXSceneSession
  4. 工具包1.8.1及以上版本注意区分开发版、体验版、正式版
WXMiniProgramObject *object = [WXMiniProgramObject object];
object.webpageUrl = webpageUrl;
object.userName = userName;
object.path = path;
object.hdImageData = hdImageData;
object.withShareTicket = withShareTicket;
object.miniProgramType = programType;

WXMediaMessage *message = [WXMediaMessage message];
message.title = @"小程序标题";
message.description = @"小程序描述";
message.thumbData = nil;  //兼容旧版本节点的图片,小于32KB,新版本优先
                          //使用WXMiniProgramObject的hdImageData属性
message.mediaObject = object;

SendMessageToWXReq *req = [[SendMessageToWXReq alloc] init];
req.bText = NO;
req.message = message;
req.scene = WXSceneSession;  //目前只支持会话
[WXApi sendReq:req];

WXMiniProgramObject对应字段解释:

  1. webpageUrl(NSString类型) 网页链接
  2. userName(NSString类型) 小程序原始ID,登录小程序管理后台-设置-基本设置-帐号信息 获取
  3. path(NSString类型) 小程序对应的页面路径,例如“/pages/good_detail?id=487”
  4. hdImageData(NSData类型) 预览图二进制数据,用于在新版本微信App上展示的图片,大小不得超过128KB,建议图片长宽比例为5:4
  5. withShareTicket(BOOL类型) 用于分享出去的小程序被二次打开的时候可以获取更多的信息
  6. miniprogramType(枚举类型) 对应小程序的类型,支持开发者区分开发版和体验版

WXMediaMessage对应的字段解释:

  1. title(NSString类型) 标题,与网页类型分享一致
  2. description(NSString类型) 描述,与网页类型分享一致
  3. thumbData(UIImage类型) 预览图,大小不得超过32K,与网页类型分享一致,

使用版本低于6.5.6的iPhone客户端或iPad客户端接收(也就是没有小程序功能)其注意点:

  1. 预览图thumbData:新版本上使用WXMiniProgramObject的hdImageData属性,旧版本的使用WXMediaMessage的thumbData属性
  2. 网页链接webpageUrl:改属性在WXMiniProgramObject和WXWebpageObject中的区别是在低版本小程序类型会自动转换成网页类型,只有填写了这个字段才能确保用户能正常打开

微信授权登录
微信支付

如果本文对你有所帮助记得点个赞哈

上一篇 下一篇

猜你喜欢

热点阅读