dlt.systemShare
简介
使用 Android 系统分享的 API ,具体可分享的渠道,等同系统的能力。该 API 仅对内部开放。
使用限制
基础库从 3.0.0
或更高版本支持。
参数
Object object
属性 | 类型 | 默认值 | 必填 | 描述 |
---|---|---|---|---|
shareContent | string | 否 | 分享文本内容 | |
shareFilePath | string | 否 | 分享文件的地址,本地路径(图片、视频、文件) | |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
注:两个参数必填二选一,优先级为 shareFilePath 最高,例如 shareFilePath、shareContent 两者都不为空,则先尝试寻找文件,若是文件找到则分享文件,文件找不到则分享文本内容
object.success 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
success | string | true-成功 |
object.fail 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
success | string | false-失败 |
errMsg | string | 错误信息: 1. Parameter error: S10001 2. Share File Failed, no write permission : S10002 3. ShareContent is empty: S10003 4. Share Failed: S10004 |
示例代码
// pages/index/index.js
Page({
share() {
dlt.systemShare({
shareContent: "hello world",
shareFilePath: 'images/xxx.png'
});
},
});