钉钉分享
调用接口会先检测是否安装钉钉,以及当前钉钉版本是否支持分享。
[!TIP|labelVisibility:hidden|iconVisibility:hidden] navigator.ddshare.share(options,successCallback,errorCallback)
支持平台:
- Android
- iOS
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| options | Object | 是 | 参数对象 |
| successCallback | Function | 否 | 成功回调函数 |
| errorCallback | Function | 否 | 失败回调函数 |
options参数对象的类型为ShareTextObject、ShareImageObject、ShareWebpageObject。
构造函数
ShareTextObject: function (text){}ShareImageObject: function (shareImage){}ShareWebpageObject: function (webpageUrl, title){}
ShareTextObject对象,包含以下属性:
text(String / 必选) -- 分享的文本,长度iOS不超过 1K,长度Android不超过 10K.
ShareImageObject对象,包含以下属性:
shareImage(String / 可选) -- 分享的图片URL,支持http/https/file/cdvfile,图片内容大小不能超过 10M,图片URL长度不能超过 10K.
ShareWebpageObject对象,包含以下属性:
webpageUrl(String / 必选) --URL链接(可以是网页链接、音频链接、视频链接),支持http/https,长度不能超过 10Ktitle(String / 可选) -- 标题,长度不超过 512Bytedescription(String / 可选) -- 描述,长度不超过 1KthumbImage(String / 可选) -- 缩略图URL,支持http/https/file/cdvfile,图片内容大小不能超过 32K,图片URL长度不超过 10K
successCallback函数会返回一个字符串,字符串内容为分享结果信息
errorCallback函数会返回一个字符串,分享错误的相关信息
示例代码
分享文字
// 引用js
<script src='supconit://hcmobile.js'></script>
<script>
// 监听’deviceready‘事件
document.addEventListener('deviceready', onDeviceReady, false)
function onDeviceReady(){
// 分享文字
var obj = new ShareTextObject('钉钉文字分享测试');
navigator.ddshare.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('http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg');
navigator.ddshare.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://y.qq.com/i/song.html?songid=432451&source=mobileQQ%23wechat_redirect';
obj.title = '歌曲名:不要说话';
obj.description = '专辑名:不想放手歌手名:陈奕迅';
obj.thumbImage = 'http://imgcache.qq.com/music/photo/mid_album_300/V/E/000J1pJ50cDCVE.jpg';
navigator.ddshare.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://url.cn/5ciXSIz';
obj.title = '视频《画》';
obj.description = 'G.E.M.邓紫棋';
obj.thumbImage = 'http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg';
navigator.ddshare.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 = '网页标题';
obj.thumbImage = 'http://hot.online.sh.cn/images/attachement/jpeg/site1/20180225/IMGf48e3894467146954814361.jpeg';
navigator.ddshare.share(obj, function (successCallback) {
alert(JSON.stringify(successCallback));
}, function (errorCallback) {
alert(JSON.stringify(errorCallback));
});
}
</script>
响应示例代码:
"分享成功"