微信分享
[!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>