普通小游戏开发
API
开放能力
数据分析
视频拍摄器
多端支持

分享逻辑

本文档会说明分享过程相关的主要逻辑,api 之间的调用关系。

名词解释

ShareOption

ShareOption 是指系统调用开发者(通过 tt.onShareAppMessage )注册的回调时,传递给回调函数的参数,会包括 channel 字段。

ShareParam

ShareParam 是指开发者最终传递给发布器的数据,可以根据约定传入部分自定义数据。具体字段可查阅ShareParam 对象说明。

入口控制

  • 可以通过 tt.showShareMenutt.hideShareMenu 控制更多菜单中是否出现分享按钮。
  • 开发者在开发小游戏时,可以在图形界面绘制自定义按钮,在按钮的回调中调用 tt.shareAppMessage 来直接调起发布器。

分享调用流程图

如上图所示,调用可大体分为主动调用(D)和被动调用(A、B、C)两种模式。小程序只能使用被动调用,小游戏可以使用主动和被动两种。

主动调用

主动调用是指 —— 开发者直接通过 ​tt.shareAppMessage(shareParam)​ 方法,将 shareParam 传递给系统发布器即可。

被动调用

被动调用是指 —— 无论用户点击何种入口,小游戏框架均会将 shareOption 带给 ​tt.onShareAppMessage(callback)​ 方法中注册的 ​callback​ 回调。开发者可以在回调函数中根据接收的参数处理相应逻辑,最后返回 shareParam 即可。

分享效果

一键分享

开发者使用录屏分享时,如果未使用剪映模版和录屏配音(defaultBgm 字段) 能力时,将触发一键分享逻辑,将会弹出一键分享弹框,如下:

用户在点击一键分享后,将直接分享视频到宿主,完成分享能力。

点击纠错
评价此篇文档