微信開發(fā)平臺:https://open.weixin.qq.com
iOS Demo:https://github.com/Geniune/WXApi (記得給個star哦)
微信分享功能支持以下六種類型:
- 文字類型
- 圖片類型
- 音樂類型
- 視頻類型
- 網(wǎng)頁類型
- 小程序類型
本文主要描述:分享網(wǎng)頁類型、分享小程序類型、打開小程序
目標(biāo)場景有三個,通過SendMessageToWXReq的scene屬性區(qū)分:
- WXSceneSession 分享到消息會話
- WXSceneTimeline 分享到朋友圈
- WXSceneFavorite 添加到收藏
2020年7月17日更新
1.網(wǎng)頁類型分享
網(wǎng)頁類型分享是平時使用頻率最高的功能,其內(nèi)容包括:標(biāo)題+描述+縮略圖+點擊跳轉(zhuǎn)的URL鏈接。
如圖所示京東的商品分享:

分享示例代碼:
if([WXApi isWXAppInstalled]){//判斷當(dāng)前設(shè)備是否安裝微信客戶端
//創(chuàng)建多媒體消息結(jié)構(gòu)體
WXMediaMessage *urlMessage = [WXMediaMessage message];
urlMessage.title = @"【爆款直降 盛夏特惠】【29.9免郵 限量買3免1】清新持久自然GUCCMI香水";//標(biāo)題
urlMessage.description = @"我在京東發(fā)現(xiàn)了一個不錯的商品,趕快來看看吧。";//描述
[urlMessage setThumbImage:[UIImage imageNamed:@"res2.png"]];//設(shè)置預(yù)覽圖
//創(chuàng)建網(wǎng)頁數(shù)據(jù)對象
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(@"發(fā)起分享:%@", success ? @"成功" : @"失敗");
}];
}else{
//提示:未安裝微信應(yīng)用或版本過低
}
//分享回調(diào)
- (void)onResp:(id)resp{
if([resp isKindOfClass:[SendMessageToWXResp class]]){
SendMessageToWXResp *req = (SendMessageToWXResp *)resp;
//注意:這里不再返回用戶是否分享完成事件,即原先的cancel事件和success事件將統(tǒng)一為success事件
}
}
實際使用過程中有幾個點需要注意:
1、很多時候分享所需數(shù)據(jù)需要通過http請求或和html交互等方式獲得,而這個過程又是異步的,在發(fā)起微信分享時請保證在主線程上操作;
2、微信SDK要求分享圖片大小不得超過64K,否則會導(dǎo)致分享失?。ㄉ磉吅芏嘈』锇楸贿@個坑過)。而通常開發(fā)過程中圖片可能只是一個URL,像素和圖片文件大小不得而知,我的解決辦法是先對圖片進(jìn)行裁剪,再壓縮,代碼如下:
- (UIImage *)imageWithImage:(UIImage*)image scaledToSize:(CGSize)newSize{
UIGraphicsBeginImageContext(newSize);
[image drawInRect:CGRectMake(0,0,newSize.width,newSize.height)];//根據(jù)newSize對圖片進(jìn)行裁剪
UIImage* newImage = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
return [UIImage imageWithData:UIImageJPEGRepresentation(newImage, 0.5)];//壓縮50%
}
最近同事發(fā)現(xiàn)個問題,就是無論如何操作,返回結(jié)果都是分享成功(即使取消分享也一樣)
后來經(jīng)過查看開放平臺調(diào)整通知,才知道人家微信團(tuán)隊已經(jīng)修改過了,具體調(diào)整如下:

重點:分享接口調(diào)用后,不再返回用戶是否分享完成事件,即原先的cancel事件和success事件將統(tǒng)一為success事件。
2.小程序類型分享
更新于(2019年2月20日)
在開發(fā)前,需要做的準(zhǔn)備工作:
- 更新WeChatSDK也就是開發(fā)者工具包至最新版本,1.7.7以前的版本不能分享小程序
- 申請對應(yīng)的小程序賬號并審核通過,并且保證原生App和小程序?qū)儆?strong>同一個微信開發(fā)平臺賬號(重要?。。?/li>
- 與其他類型不同,小程序類型只支持分享至消息會話,scene屬性只能使用WXSceneSession
- 工具包1.8.1及以上版本注意區(qū)分開發(fā)版、體驗版、正式版
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 = @"小程序標(biāo)題";
message.description = @"小程序描述";
message.thumbData = nil; //兼容舊版本節(jié)點的圖片,小于32KB,新版本優(yōu)先
//使用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對應(yīng)字段解釋:
- webpageUrl(NSString類型) 網(wǎng)頁鏈接
- userName(NSString類型) 小程序原始ID,登錄小程序管理后臺-設(shè)置-基本設(shè)置-帳號信息 獲取
- path(NSString類型) 小程序?qū)?yīng)的頁面路徑,例如“/pages/good_detail?id=487”
- hdImageData(NSData類型) 預(yù)覽圖二進(jìn)制數(shù)據(jù),用于在新版本微信App上展示的圖片,大小不得超過128KB,建議圖片長寬比例為5:4
- withShareTicket(BOOL類型) 用于分享出去的小程序被二次打開的時候可以獲取更多的信息
- miniprogramType(枚舉類型) 對應(yīng)小程序的類型,支持開發(fā)者區(qū)分開發(fā)版和體驗版
WXMediaMessage對應(yīng)的字段解釋:
- title(NSString類型) 標(biāo)題,與網(wǎng)頁類型分享一致
- description(NSString類型) 描述,與網(wǎng)頁類型分享一致
- thumbData(UIImage類型) 預(yù)覽圖,大小不得超過64K,與網(wǎng)頁類型分享一致,
使用版本低于6.5.6的iPhone客戶端或iPad客戶端接收(也就是沒有小程序功能)其注意點:
- 預(yù)覽圖thumbData:新版本上使用WXMiniProgramObject的hdImageData屬性,舊版本的使用WXMediaMessage的thumbData屬性
- 網(wǎng)頁鏈接webpageUrl:改屬性在WXMiniProgramObject和WXWebpageObject中的區(qū)別是在低版本小程序類型會自動轉(zhuǎn)換成網(wǎng)頁類型,只有填寫了這個字段才能確保用戶能正常打開
3.打開小程序
想要打開一個小程序,必須擁有該小程序的原始ID(注意:不是APP ID),原始ID需要從微信公眾平臺中獲取,最簡單的辦法是咨詢開發(fā)小程序的童鞋即可,通常格式為:gh_2973ddbbc433
if([WXApi isWXAppInstalled]){//判斷是否已安裝微信App
WXLaunchMiniProgramReq *launchMiniProgramReq = [WXLaunchMiniProgramReq object];
launchMiniProgramReq.userName = @"gh_2973ddbbc433"; //小程序的原始ID
launchMiniProgramReq.path = @""; //小程序頁面的可帶參路徑,不填默認(rèn)拉起小程序首頁
launchMiniProgramReq.miniProgramType = WXMiniProgramTypeRelease; //類型:正式版
[WXApi sendReq:launchMiniProgramReq completion:^(BOOL success) {
NSLog(@"打開微信小程序:%@", success ? @"成功" : @"失敗");
}];
}else{
//提示未安裝微信應(yīng)用或版本過低
}
微信授權(quán)登錄
微信支付
適配Universal Links
如果本文對你有所幫助記得點個贊哈