# uni.getLaunchOptionsSync()

获取启动时的参数。返回值与App.onLaunch的回调参数一致

App web 微信小程序 支付宝小程序 抖音小程序 QQ小程序 快手小程序 钉钉小程序 飞书小程序 百度小程序 京东小程序 元服务 小红书小程序
√ (3.4.10+) √ (见下) √ √ √ √ √ √ √ x x √ √

# getLaunchOptionsSync 兼容性

HarmonyOS
HBuilderX 4.31

web平台不同Vue版本支持情况有差异:

  • vue2项目:uni-app 3.5.1+ 支持
  • vue3项目:uni-app 3.2.13+ 支持

返回参数说明

参数名 类型 说明 平台差异说明
path string 启动的路径(代码包路径,注意:App 端开发过程中热更新会直达当前页面,此时启动路径为当前页面路径)
scene number 启动时的场景值,具体值含义请查看各平台文档说明。App、web端恒为 1001。钉钉小程序在 IDE 恒为0000,真机不支持。
query object 启动时的 query 参数
appScheme string 首次启动时的Scheme。返回值与App.onLaunch的回调参数一致 仅 HarmonyOS 4.81+ 支持
appLink string 首次启动时的appLink。返回值与App.onLaunch的回调参数一致 仅 HarmonyOS 4.81+ 支持
referrerInfo object 来源信息。如果没有则返回 {} 飞书和钉钉小程序不支持
channel string 如果应用没有设置渠道标识,则返回空字符串。取值如下 仅 App 支持
launcher string 应用启动来源。取值如下 仅 App 支持
forwardMaterials Array<object> 打开的文件信息数组,只有从聊天素材场景打开(scene为1173)才会携带该参数 微信小程序、QQ小程序
entryDataHash string 群入口信息,通过群应用商店打开、群分享卡片打开的小程序可获得 仅QQ小程序
chatType number 打开的文件信息数组,只有从聊天素材场景打开(scene为1173)才会携带该参数 仅微信小程序
apiCategory string API 类别 仅微信小程序(2.20.0+)
showFrom number 唤起小程序的方式,目前取值固定为 10,表示通过 schema 唤起 仅抖音小程序(1.90.0+)
mode 'default' | 'halfPage' 启动小程序的模式 仅快手小程序
subScene string 子场景值(定义待补充) 仅飞书小程序

object referrerInfo

属性 类型 说明 平台差异说明
appId string 来源小程序 appId 其他平台均支持,抖音小程序(1.15.0+)
extraData object 来源小程序传过来的数据 其他平台均支持,抖音小程序(1.15.0+)

channel 取值

默认提供 7 个渠道(Google、360、小米、华为、应用宝、vivo、oppo),更多可以在manifest.json文件中【源码视图】进行配置,详情

默认渠道 渠道标识ID
GooglePlay google
应用宝 yyb
360应用市场 360
华为应用商店 huawei
小米应用商店 xiaomi
vivo应用商店 vivo
oppo应用商店 oppo

launcher 取值

值 说明
default 默认启动方式,通常表示应用列表启动(360手助中搜索启动)
scheme 通过urlscheme方式触发启动
push 通过点击系统通知方式触发启动
uniLink 通过通用链接(universal link)启动应用
miniProgram 通过微信小程序启动应用
shortcut 通过快捷方式启动,iOS平台表示通过3D Touch快捷方式,Android平台表示通过桌面快捷方式启动
barcode 通过二维码扫描启动