• JS API 列表
  • 基础
  • tt.canIUse
  • tt.base64ToArrayBuffer
  • tt.arrayBufferToBase64
  • 生命周期
  • tt.canIPutStuffOverComponent
  • 版本更新
  • 定时器
  • 应用级事件
  • tt.onAppShow
  • tt.offAppShow
  • tt.onAppHide
  • tt.offAppHide
  • tt.offUnhandledRejection
  • tt.onError
  • tt.offError
  • tt.onLazyLoadError
  • tt.offLazyLoadError
  • tt.onUnhandledRejection
  • tt.onAppLaunch
  • tt.offAppLaunch
  • 环境变量
  • 性能
  • 线程
  • 窗口尺寸变化
  • tt.setPageInfo
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • tt.onAppLaunch
    收藏
    我的收藏

    基础库 2.8.0 开始支持本方法,这是一个同步方法。
    监听小程序启动事件。该事件与 App.onLaunch 的回调时机与参数一致。

    语法

    tt.onAppLaunch(callback)

    参数说明

    callback

    类型
    默认值
    必填
    说明
    最低支持版本
    function
    启动事件的回调参数
    2.8.0

    回调函数参数说明

    object 类型,属性如下:
    属性名
    类型
    说明
    最低支持版本
    path
    string
    小程序启动页面路径
    2.8.0
    scene
    string
    小程序启动场景值
    2.8.0
    query
    object
    小程序启动参数
    2.8.0
    refererInfo
    RefererInfo
    来源信息,从另一个小程序进入小程序时会有具体信息,否则返回 {}
    2.8.0
    showFrom
    number
    唤起小程序的方式,目前取值固定为 10,表示通过 schema 唤起
    2.8.0
    RefererInfo 类型说明
    object 类型,属性如下:
    属性名
    类型
    说明
    最低支持版本
    appId
    string
    来源小程序的 appId
    2.8.0
    extraData
    object
    来源小程序传过来的数据,场景值为 "011009" 或 "011010" 时支持
    2.8.0

    扫码体验

    代码示例

    <view class="content"> <text class="title">小程序启动参数:</text> <view class="attr-wrap"> <text class="attr">scene: {{launchQuery.scene}}</text> <text class="attr">path: {{launchQuery.path}}</text> <text class="attr">query: {{launchQuery.query}}</text> <text class="attr">referrerInfo: {{launchQuery.referrerInfo}}</text> <text class="attr">showFrom: {{launchQuery.showFrom}}</text> </view> <button size="default" class="clear-btn" bindtap="clearAllAttr" disabled="{{!launchQuery.path}}"> 清空上面参数 </button> </view>
    Page({ data: { launchQuery: {}, }, onLoad: function (options) { tt.onAppLaunch((res) => { const params = Object.assign({}, res); console.log("scene: ", params.scene); console.log("path: ", params.path); console.log("query: ", params.query); console.log("referrerInfo: ", params.referrerInfo); console.log("showFrom: ", params.showFrom); params.query = params.query && JSON.stringify(params.query); params.referrerInfo = params.referrerInfo && JSON.stringify(params.referrerInfo); this.setData({ launchQuery: params, }); console.log("onAppLaunch success"); tt.showToast({ title: "已成功监听小程序启动事件", icon: "none", duration: 3000, }); }); }, clearAllAttr() { this.setData({ launchQuery: {}, }); }, });

    Bug & Tip