微信分享
[!TIP|labelVisibility:hidden|iconVisibility:hidden] navigator.wechat.share(options,successCallback,errorCallback)
支持平台:
- Android
- iOS
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| options | Object | 是 | 参数对象 |
| successCallback | Function | 否 | 成功回调函数 |
| errorCallback | Function | 否 | 失败回调函数 |
options参数对象的类型为ShareTextObject、ShareImageObject、ShareMusicObject、ShareVideoObject、ShareWebpageObject。
构造函数
ShareTextObject: function (text, scene){}ShareImageObject: function (shareImage){}ShareMusicObject: function (musicUrl, title, description, thumbImage, scene){}ShareVideoObject: function (videoUrl, title, description, thumbImage, scene){}ShareWebpageObject: function (webpageUrl, title, description, thumbImage, scene){}
ShareTextObject对象,包含以下属性:
text( String / 必选 ) -- 分享的文本,文本长度必须大于0且小于10Kscene( ShareScene / 可选) -- 分享场景,其值可为:ShareScene.WechatSession-- 微信好友,默认ShareScene.WechatTimeLine-- 微信朋友圈
ShareImageObject对象,包含以下属性:
shareImage( String / 必选 ) -- 分享的图片URL,支持http/https/file/cdvfile,图片大小不能超过25Mscene( ShareScene / 可选 ) -- 分享场景,其值可为:ShareScene.WechatSession-- 微信好友,默认ShareScene.WechatTimeLine-- 微信朋友圈
ShareMusicObject对象,包含以下属性:
musicUrl( String / 必选 ) -- 音乐网页的url地址,支持http/https,长度不能超过10Ktitle( String / 可选 ) -- 标题,长度不能超过512字节description( String / 可选 ) -- 描述,长度不能超过1KthumbImage( String / 可选 ) -- 缩略图URL,支持http/https/file/cdvfile,大小不能超过32Kscene( ShareScene / 可选 ) -- 分享场景,其值可为:ShareScene.WechatSession-- 微信好友,默认ShareScene.WechatTimeLine-- 微信朋友圈
musicDataUrl( String / 可选 ) -- 音乐数据url地址,支持http/https,长度不能超过10KmusicLowBandUrl( String / 可选 ) -- 音乐lowband网页的url地址,支持http/https,长度不能超过10KmusicLowBandDataUrl( String / 可选 ) -- 音乐lowband数据url地址,支持http/https,长度不能超过10K
ShareVideoObject对象,包含以下属性:
videoUrl( String / 必选 ) -- 视频网页的url地址,支持http/https,长度不能超过10Ktitle( String / 可选 ) -- 标题,长度不能超过512字节description( String / 可选 ) -- 描述,长度不能超过1KthumbImage( String / 可选 ) -- 缩略图URL,支持http/https/file/cdvfile,大小不能超过32Kscene( ShareScene / 可选 ) -- 分享场景,其值可为:ShareScene.WechatSession-- 微信好友,默认ShareScene.WechatTimeLine-- 微信朋友圈
videoLowBandUrl( String / 可选 ) -- 视频lowband网页的url地址,支持http/https,长度不能超过10K
ShareWebpageObject对象,包含以下属性:
webpageUrl(String / 必选) -- 网页URL,支持http/https,长度不能超过10Ktitle(String / 可选) -- 标题,长度不能超过512字节description(String / 可选) -- 描述,长度不能超过1KthumbImage(String / 可选) -- 缩略图URL,支持http/https/file/cdvfile,大小不能超过32Kscene(ShareScene / 可选) -- 分享场景,其值可为:ShareScene.WechatSession-- 微信好友,默认ShareScene.WechatTimeLine-- 微信朋友圈
successCallback函数没有返回
errorCallback函数会返回一个字符串,分享错误的相关信息
示例代码
分享文字
// 引用js
<script src='supconit://hcmobile.js'></script>
<script>
// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
// 分享文字
var obj = new ShareTextObject('分享文字',ShareScene.WechatSession);
navigator.wechat.share(obj,function (successCallback) {
alert(JSON.stringify(successCallback));
},function (errorCallback){
alert(JSON.stringify(errorCallback));
});
}
</script>
分享图片
// 引用js
<script src='supconit://hcmobile.js'></script>
<script>
// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
// 分享图片
var obj = new ShareImageObject();
obj.shareImage = 'http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg';
obj.scene = ShareScene.WechatTimeLine;
navigator.wechat.share(obj,function (successCallback) {
alert(JSON.stringify(successCallback));
},function (errorCallback){
alert(JSON.stringify(errorCallback));
});
}
</script>
分享音乐
// 引用js
<script src='supconit://hcmobile.js'></script>
<script>
// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
// 分享音乐
var obj = new ShareMusicObject('http://music.163.com/song/media/outer/url?id=28587850.mp3','音乐标题','描述','http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg',ShareScene.WechatSession);
obj.musicDataUrl = 'http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg';
obj.musicLowBandUrl = '';
obj.musicLowBandDataUrl = '';
navigator.wechat.share(obj,function (successCallback) {
alert(JSON.stringify(successCallback));
},function (errorCallback){
alert(JSON.stringify(errorCallback));
});
}
</script>
分享视频
// 引用js
<script src='supconit://hcmobile.js'></script>
<script>
// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
// 分享视频
var obj = new ShareVideoObject('http://yoo.qq.com/m/video.html?id=j08143jnfo6&ptag=txvideo12&first=1&ptag=4_6.5.0.21999_copy','视频标题','描述','http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg',
ShareScene.WechatSession);
obj.videoLowBandUrl = '';
navigator.wechat.share(obj,function (successCallback) {
alert(JSON.stringify(successCallback));
},function (errorCallback){
alert(JSON.stringify(errorCallback));
});
}
</script>
分享网页
// 引用js
<script src='supconit://hcmobile.js'></script>
<script>
// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
// 分享网页
var obj = new ShareWebpageObject('http://www.qlwb.com.cn/2019/0214/1397405.shtml','网页标题','描述','http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg',
ShareScene.WechatSession);
navigator.wechat.share(obj,function (successCallback) {
alert(JSON.stringify(successCallback));
},function (errorCallback){
alert(JSON.stringify(errorCallback));
});
}
</script>