QQ分享
调用接口会先检测是否安装QQ。对未安装的用户会提示"没有安装QQ"[!TIP|labelVisibility:hidden|iconVisibility:hidden] navigator.qq.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 / 必选 ) -- 分享的文本,长度最长1536个字符scene( ShareScene / 可选 ) -- 分享场景,其值可为:ShareScene.QQ--QQ好友,默认ShareScene.Qzone--QQ空间
qq_target_url( String / 必选 ) -- 跳转的url(现在默认为http://supconit.com,不让手动填写) 注:此参数只用于Android端,iOS端不用传
ShareImageObject对象,包含以下属性:
shareImage( String / 必选 ) -- 分享的图片URL,支持 http/https/file/cdvfile,图片大小最大5M字节scene( ShareScene / 可选 ) -- 分享场景,其值可为:ShareScene.QQ--QQ好友,默认ShareScene.Qzone--QQ空间
ShareMusicObject对象,包含以下属性:
musicUrl( String / 必选 ) -- 音乐网页的url地址,支持http/https,最长512个字符title( String / 必选 ) -- 标题,最长128个字符description( String / 可选 ) -- 描述,最长512个字符thumbImage( String / 可选 ) -- 缩略图URL,支持http/https/file/cdvfile,图片最大1M字节scene( ShareScene / 可选 ) -- 分享场景,其值可为:ShareScene.QQ--QQ好友,默认ShareScene.Qzone--QQ空间
ShareVideoObject对象,包含以下属性:
videoUrl( String / 必选 ) -- 视频URL,支持http/https,最长512个字符title( String / 必选 ) -- 标题,最长128个字符description( String / 可选 ) -- 描述,最长512个字符thumbImage( String / 可选 ) -- 缩略图URL,支持http/https/file/cdvfile,图片最大1M字节scene( ShareScene / 可选 ) -- 分享场景,其值可为:ShareScene.QQ--QQ好友,默认ShareScene.Qzone--QQ空间
ShareWebpageObject对象,包含以下属性:
webpageUrl(String / 必选) -- 网页URL,支持http/https,最长512个字符title(String / 必选) -- 标题,最长128个字符description(String / 可选) -- 描述,最长512个字符thumbImage(String / 可选) -- 缩略图URL,支持http/https/file/cdvfile,图片最大1M字节scene(ShareScene / 可选) -- 分享场景,其值可为:ShareScene.QQ--QQ好友,默认ShareScene.Qzone--QQ空间
successCallback函数会返回一个字符串,字符串内容为分享结果信息
errorCallback函数会返回一个字符串,分享错误的相关信息
示例代码
分享文字
// 引用js
<script src='supconit://hcmobile.js'></script>
<script>
// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
// 分享文字
var obj = new ShareTextObject('分享文字',ShareScene.QQ);
navigator.qq.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.QQ;
navigator.qq.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://y.qq.com/i/song.html?songid=432451&source=mobileQQ%23wechat_redirect','歌曲名:不要说话','专辑名:不想放手歌手名:陈奕迅','http://imgcache.qq.com/music/photo/mid_album_300/V/E/000J1pJ50cDCVE.jpg',ShareScene.QQ);
navigator.qq.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://url.cn/5ciXSIz','视频《画》',
'G.E.M.邓紫棋','http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg',
ShareScene.QQ);
navigator.qq.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();
obj.webpageUrl = 'http://www.qlwb.com.cn/2019/0214/1397405.shtml';
obj.title = '网页标题';
navigator.qq.share(obj,function (successCallback) {
alert(JSON.stringify(successCallback));
},function (errorCallback){
alert(JSON.stringify(errorCallback));
});
}
</script>
响应示例代码:
"分享成功"