调起方法
收藏
我的收藏

警告

此文档将逐步废弃，后续不再维护，请参考转发和挂载概述进行接入。

名词解释

shareOption——系统调用开发者注册的回调时，传递给回调的数据，包括用户选择的调起方式等

shareParam——开发者最终传递给发布器的数据，可以根据约定传入部分自定义数据

入口控制

如果显示定义了 [Page|tt].onShareAppMessage(callback) 方法，在小程序右上角胶囊按钮里会自动带上「分享」「发头条」等入口。其中小程序里的方法注册在 Page 上，小游戏直接挂在 tt 上

无论是否显示定义上述方法，均可以通过 tt.showShareMenu() 和 tt.hideShareMenu() 控制入口的显示与隐藏

开发者在开发小程序时，还可以在 TTML/TTML 文件里通过 button 组件自定义入口。其中通过 data-channel 字段指定调起方式（默认为「分享」），如：

HTML复制
<button class="custom-share-button" open-type="share" data-channel="video" data-qrcode="inv34+23==">Click Me!</button>

开发者在开发小程序时，可以在图形界面绘制自定义按钮，在按钮的回调中调用 tt.shareAppMessage(shareParam) 来直接调起发布器

调用逻辑

如上图所示，调用可大体分为主动调用（D）和被动调用（A、B、C）两种模式。

主动调用

开发者直接通过 tt.shareAppMessage(shareParam) 方法（仅限小游戏），将 shareParam 传递给系统发布器即可。

被动调用

无论用户点击何种入口，小程序框架均会将 shareOption 带给 [Page|tt].onShareAppMessage(callback) 方法中注册的 callback 回调。开发者可以在回调中根据参数处理相应逻辑，最后返回 shareParam 即可。如：

js复制
Page({ 
  onShareAppMessage: function (shareOption) {
    switch(shareOption.channel){
      case 'video':
        return {
          extra: {
             // 注意，只有小程序使用button组件触发分享时，会有target属性
            videoPath : shareOption.target.dataset.path
          }
        };
      case 'qrcode':
        ...
        break;
      default:
        ...
        break;
    }
  },
});

其中，shareOption 的结构如下：

js复制
{ 
  from: '',     // 合法值包括 button 和 menu，分别对应两种被动分享方式
  target: null, // 当from=button时，target指向button对象，当from=menu时，target为null
  channel: '',  // 预设的分享方式（通过button分享时，取值自data-channel）
}

onShareAppMessage 方法返回的对象我们称之为 shareParam，它的结构如下：

js复制
{ 
  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