调起方法收藏我的收藏
收藏
我的收藏警告
名词解释
- 1.shareOption——系统调用开发者注册的回调时,传递给回调的数据,包括用户选择的调起方式等
- 2.shareParam——开发者最终传递给发布器的数据,可以根据约定传入部分自定义数据
入口控制
- 1.如果显示定义了 [Page|tt].onShareAppMessage(callback) 方法,在小程序右上角胶囊按钮里会自动带上「分享」「发头条」等入口。其中小程序里的方法注册在 Page 上,小游戏直接挂在 tt 上
- 2.无论是否显示定义上述方法,均可以通过 tt.showShareMenu() 和 tt.hideShareMenu() 控制入口的显示与隐藏
- 3.开发者在开发小程序时,还可以在 TTML/TTML 文件里通过 button 组件自定义入口。其中通过 data-channel 字段指定调起方式(默认为「分享」),如:
<button class="custom-share-button" open-type="share" data-channel="video" data-qrcode="inv34+23==">Click Me!</button>
- 4.开发者在开发小程序时,可以在图形界面绘制自定义按钮,在按钮的回调中调用 tt.shareAppMessage(shareParam) 来直接调起发布器
调用逻辑
如上图所示,调用可大体分为主动调用(D)和被动调用(A、B、C)两种模式。
主动调用
开发者直接通过 tt.shareAppMessage(shareParam) 方法(仅限小游戏),将 shareParam 传递给系统发布器即可。
被动调用
无论用户点击何种入口,小程序框架均会将 shareOption 带给 [Page|tt].onShareAppMessage(callback) 方法中注册的 callback 回调。开发者可以在回调中根据参数处理相应逻辑,最后返回 shareParam 即可。如:
Page({ onShareAppMessage: function (shareOption) { switch(shareOption.channel){ case 'video': return { extra: { // 注意,只有小程序使用button组件触发分享时,会有target属性 videoPath : shareOption.target.dataset.path } }; case 'qrcode': ... break; default: ... break; } }, });
其中,shareOption 的结构如下:
{ from: '', // 合法值包括 button 和 menu,分别对应两种被动分享方式 target: null, // 当from=button时,target指向button对象,当from=menu时,target为null channel: '', // 预设的分享方式(通过button分享时,取值自data-channel) }
onShareAppMessage 方法返回的对象我们称之为 shareParam,它的结构如下:
{ channel: '', title: '', imageUrl: '', path: '', extra: { videoTopics: ['话题一', '话题二'], // 只有抖音支持该属性 videoPath: '' } }
shareParam 这个对象的属性分为基础参数和扩展参数 extra 两部分。
基础参数说明
所有的分享/发布内容都需要经过独立的审核后才会放出。
开发者可以在开放平台后台预先设置好一些分享默认内容,当实际代码所指定的内容审核通过前,会展示该默认内容。
属性 | 说明 |
channel | 指定发布器的调用方式,默认为 share。具体内容见下方「特殊参数说明」 |
title | 想要分享/发布的内容标题。 |
imageUrl | 想要分享/发布的内容,当调用方式支持传入一张图片时,可以通过此参数指定。 |
query/path | 分享/发布的内容会自动与小程序绑定,同时在 UI 上提供进入小程序的入口。开发者如果想为该入口添加参数可以通过设置 query/path 实现。其中小程序需要传递 path 字段,小游戏是 query 字段。 |
扩展参数 extra 说明
只有当 channel 为 video(即发布视频)时可以指定 extra 属性,extra 可以有
videoTopics
、withVideoId
和videoPath
三个字段:videoTopics
类型string[], 可以在分享内容中插入指定话题,该字段只有抖音内支持videoPath
类型string, 可以指定本地视频,如果不提供该字段,则调起摄像头拍摄withVideoId
类型Boolean, 指定在 success 回调函数中返回 videoId, 并可以通过 videoId 调用button(open-type=navigateToVideoView) 播放
整体可以参考以下表格
功能描述 | channel | 支持的 app | 基础参数说明 | extra 参数说明 |
分享面板 | share | 今日头条抖音 | 无 | 无 |
发布图文内容 | article | 今日头条 | 无 | 无 |
发布视频内容 | video | 今日头条 | 不支持 imageUrl,title 参数 | 可以指定一个本地视频直接进入编辑页面 videoPath |
发布视频内容 | video | 抖音 | 1. 不支持 imageUrl 参数 2. title 参数在发布过程中对用户透明,经审核后可放出 | 1. 话题列表 videoTopics 2. 可以指定一个本地视频直接进入编辑页面 videoPath |
常见问题