调起方法

名词解释

1. shareOption——系统调用开发者注册的回调时，传递给回调的数据，包括用户选择的调起方式等
2. shareParam——开发者最终传递给发布器的数据，可以根据约定传入部分自定义数据

入口控制

1. 如果显示定义了 ​[Page|tt].onShareAppMessage(callback)​ 方法，在小程序右上角胶囊按钮里会自动带上「分享」「发头条」等入口。其中小程序里的方法注册在 ​Page​ 上，小游戏直接挂在 ​tt​ 上
2. 无论是否显示定义上述方法，均可以通过 ​tt.showShareMenu()​ 和 ​tt.hideShareMenu()​ 控制入口的显示与隐藏
3. 开发者在开发小程序时，还可以在 TTML/WXML 文件里通过 ​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)​ 来直接调起发布器

调用逻辑

如上图所示，调用可大体分为主动调用（C）和被动调用（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 两部分。

基础参数说明

所有的分享/发布内容都需要经过独立的审核后才会放出。 开发者可以在开放平台后台预先设置好一些分享默认内容，当实际代码所指定的内容审核通过前，会展示该默认内容。

扩展参数 extra 说明

只有当 channel 为 video（即发布视频）时可以指定 extra 属性，extra 可以有==videoTopics==、==withVideo== 和==videoPath==三个字段：

==videoTopics== 类型string[], 可以在分享内容中插入指定话题，该字段只有抖音内支持

==videoPath== 类型string, 可以指定本地视频，如果不提供该字段，则调起摄像头拍摄

==withVideoId== 类型Boolean, 指定在 success 回调函数中返回 videoId, 并可以通过 videoId 调用接口tt.navigateToVideoView播放

整体可以参考以下表格