微信开发平台:https://open.weixin.qq.com
iOS Demo:https://github.com/Geniune/WXApi (记得给个star哦)
微信分享功能支持以下六种类型:
- 文字类型
- 图片类型
- 音乐类型
- 视频类型
- 网页类型
- 小程序类型
本文主要描述:分享网页类型、分享小程序类型、打开小程序
目标场景有三个,通过SendMessageToWXReq的scene属性区分:
- WXSceneSession 分享到消息会话
- WXSceneTimeline 分享到朋友圈
- WXSceneFavorite 添加到收藏
2020年7月17日更新
1.网页类型分享
网页类型分享是平时使用频率最高的功能,其内容包括:标题+描述+缩略图+点击跳转的URL链接。
如图所示京东的商品分享:
分享示例代码:
if([WXApi isWXAppInstalled]){//判断当前设备是否安装微信客户端
//创建多媒体消息结构体
WXMediaMessage *urlMessage = [WXMediaMessage message];
urlMessage.title = @"【爆款直降 盛夏特惠】【29.9免邮 限量买3免1】清新持久自然GUCCMI香水";//标题
urlMessage.description = @"我在京东发现了一个不错的商品,赶快来看看吧。";//描述
[urlMessage setThumbImage:[UIImage imageNamed:@"res2.png"]];//设置预览图
//创建网页数据对象
WXWebpageObject *webObj = [WXWebpageObject object];
webObj.webpageUrl = @"https://open.weixin.qq.com";//链接
urlMessage.mediaObject = webObj;
SendMessageToWXReq *sendReq = [[SendMessageToWXReq alloc] init];
sendReq.bText = NO;//不使用文本信息
sendReq.message = urlMessage;
sendReq.scene = WXSceneSession;//分享到好友会话
[WXApi sendReq:sendReq completion:^(BOOL success) {
NSLog(@"发起分享:%@", success ? @"成功" : @"失败");
}];
}else{
//提示:未安装微信应用或版本过低
}
//分享回调
- (void)onResp:(id)resp{
if([resp isKindOfClass:[SendMessageToWXResp class]]){
SendMessageToWXResp *req = (SendMessageToWXResp *)resp;
//注意:这里不再返回用户是否分享完成事件,即原先的cancel事件和success事件将统一为success事件
}
}
实际使用过程中有几个点需要注意:
1、很多时候分享所需数据需要通过http请求或和html交互等方式获得,而这个过程又是异步的,在发起微信分享时请保证在主线程上操作;
2、微信SDK要求分享图片大小不得超过64K,否则会导致分享失败(身边很多小伙伴被这个坑过)。而通常开发过程中图片可能只是一个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%
}
最近同事发现个问题,就是无论如何操作,返回结果都是分享成功(即使取消分享也一样)
后来经过查看开放平台调整通知,才知道人家微信团队已经修改过了,具体调整如下:
重点:分享接口调用后,不再返回用户是否分享完成事件,即原先的cancel事件和success事件将统一为success事件。
2.小程序类型分享
更新于(2019年2月20日)
在开发前,需要做的准备工作:
- 更新WeChatSDK也就是开发者工具包至最新版本,1.7.7以前的版本不能分享小程序
- 申请对应的小程序账号并审核通过,并且保证原生App和小程序属于同一个微信开发平台账号(重要!!)
- 与其他类型不同,小程序类型只支持分享至消息会话,scene属性只能使用WXSceneSession
- 工具包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 completion:^(BOOL success) {
NSLog(@"分享微信小程序:%@", success ? @"成功" : @"失败");
}];
WXMiniProgramObject对应字段解释:
- webpageUrl(NSString类型) 网页链接
- userName(NSString类型) 小程序原始ID,登录小程序管理后台-设置-基本设置-帐号信息 获取
- path(NSString类型) 小程序对应的页面路径,例如“/pages/good_detail?id=487”
- hdImageData(NSData类型) 预览图二进制数据,用于在新版本微信App上展示的图片,大小不得超过128KB,建议图片长宽比例为5:4
- withShareTicket(BOOL类型) 用于分享出去的小程序被二次打开的时候可以获取更多的信息
- miniprogramType(枚举类型) 对应小程序的类型,支持开发者区分开发版和体验版
WXMediaMessage对应的字段解释:
- title(NSString类型) 标题,与网页类型分享一致
- description(NSString类型) 描述,与网页类型分享一致
- thumbData(UIImage类型) 预览图,大小不得超过64K,与网页类型分享一致,
使用版本低于6.5.6的iPhone客户端或iPad客户端接收(也就是没有小程序功能)其注意点:
- 预览图thumbData:新版本上使用WXMiniProgramObject的hdImageData属性,旧版本的使用WXMediaMessage的thumbData属性
- 网页链接webpageUrl:改属性在WXMiniProgramObject和WXWebpageObject中的区别是在低版本小程序类型会自动转换成网页类型,只有填写了这个字段才能确保用户能正常打开
3.打开小程序
想要打开一个小程序,必须拥有该小程序的原始ID(注意:不是APP ID),原始ID需要从微信公众平台中获取,最简单的办法是咨询开发小程序的童鞋即可,通常格式为:gh_2973ddbbc433
if([WXApi isWXAppInstalled]){//判断是否已安装微信App
WXLaunchMiniProgramReq *launchMiniProgramReq = [WXLaunchMiniProgramReq object];
launchMiniProgramReq.userName = @"gh_2973ddbbc433"; //小程序的原始ID
launchMiniProgramReq.path = @""; //小程序页面的可带参路径,不填默认拉起小程序首页
launchMiniProgramReq.miniProgramType = WXMiniProgramTypeRelease; //类型:正式版
[WXApi sendReq:launchMiniProgramReq completion:^(BOOL success) {
NSLog(@"打开微信小程序:%@", success ? @"成功" : @"失败");
}];
}else{
//提示未安装微信应用或版本过低
}
如果本文对你有所帮助记得点个赞哈