bl.shareAppMessage(Object object)
基础库 3.8.0 开始支持,低版本需做兼容处理
主动拉起分享,进入选择分享渠道界面
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 | 版本 |
---|---|---|---|---|---|
title | string | 当前小游戏的昵称 | 否 | 转发标题,不传则默认使用当前小游戏的昵称。 | |
subTitle | string | 否 | 转发副标题 | 3.8.0 | |
imageUrl | string | 当前小游戏的logo | 否 | 自定义图片路径,支持 PNG 及 JPG。建议图片分辨率 750*750 1、小游戏包内相对路径 2、blfile:// 协议路径 3、https:// 网络图片路径(暂不支持非 bilibili 图片服务器资源地址) | |
biliContent | string | 否 | 用于 分享到 【B 站动态】,模拟用户发布时手动填写的输入框内容(支持创建标签话题, eg: biliContent: "标题内容 #话题 xxx# 标题内容" | ||
biliMessageTitle | string | 当前小游戏的昵称 | 否 | 用于 分享到【B 站私信】,小游戏卡片的标题(为空时取 title 字段) | 2.2.0 |
query | String | 空 | 否 | 查询字符串,从这条转发消息进入后,可通过 bl.getLaunchOptionsSync() 或 bl.onShow() 获取启动参数中的 query。必须是 key1=val1&key2=val2 的格式。 | |
success | function | 否 | 转发成功的回调函数 | ||
fail | function | 否 | 转发失败的回调函数 | ||
complete | function | 否 | 转发结束的回调函数(转发成功、失败都会执行) |
Tips
- 分享动态支持大卡片,具体设置可查看小游戏开发指南--开放能力--转发
- 对于不是 bilibili 域名的图片,可按如下方式处理
// 第一步:下载文件到本地
bl.downloadFile({
url: 'https://example.com/image/123',
success(res) {
if (res.statusCode === 200) {
// 第二步:直接使用临时文件作为分享图
bl.shareAppMessage({
title: '转发标题',
subTitle: '转发副标题',
imageUrl: res.tempFilePath,
biliContent: '转发内容',
success(res) {
console.log(res);
},
fail(err) {
console.log(err);
}
});
}
},
fail(err) {
console.log(err);
}
});