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);
    }
});