API 概览

This content is not available in your language yet.

分类	方法	说明	异步
降级配置	`initFallback(config)`	初始化非端环境降级配置	-
	`isFallbackMode()`	判断是否处于降级模式	-
环境与配置	`isInApp()`	检测是否在 App 内运行	-
	`getEnv()`	获取运行环境信息（版本、设备、离线包等）	✓
	`setAPIEnvironment(env)`	设置项目环境（web 降级模式生效；端内 reject）	✓
	`getAPIEnvironment()`	获取当前项目环境（端内透传原生值）	✓
	`getAppName()`	获取宿主 App 名称	✓
	`getAppIcon()`	获取宿主 App 图标（Base64）	✓
	`getHostSettings(configName?)`	获取宿主云控配置	✓
	`getHostSettingsByKey(key, configName?)`	根据 key 获取宿主配置	✓
宿主方法	`callHostMethod(name, params)`	调用宿主自定义方法	✓
	`reportEvent(name, params)`	上报埋点事件	✓
	`addEventCommonParam(key, value)`	设置埋点公共参数	-
	`submitFeedback(params)`	提交用户反馈（控制台「业务运营 → 用户反馈」可查）	✓
	`openBrowser(url, title)`	打开浏览器页面	-
	`showToast(message)`	显示 Toast 提示	-
	`setStatusBarDarkMode(isDark)`	设置状态栏深/浅色	-
	`showKeyboard(selector)`	唤起软键盘（Android 空实现）	-
页面导航	`openPage(url, options)`	新页面打开 URL	-
	`closePage()`	关闭当前页面	-
	`openExternal(url)`	系统方式打开 URL（应用商店、电话等）	-
	`openWithBrowser(url)`	系统浏览器打开 URL	-
安全区域	`getSafeArea()`	获取安全区域（状态栏/导航栏高度）	-
分享	`share(content)`	调用系统分享	-
	`requestShortUrl(url, baseUrl?)`	长链接生成短链	✓
	`requestShortUrlWithHtml(html, baseUrl?)`	HTML 内容生成短链（直出渲染）	✓
生命周期	`onForeground(callback)`	监听进入前台事件	-
	`onBackground(callback)`	监听进入后台事件	-
WebView 通信	`publish(key, data, targetId)`	向其他 WebView 发送消息	-
	`subscribe(key, callback)`	监听广播消息	-
返回键	`onBackPressed(callback)`	监听返回键（可拦截）	-
	`offBackPressed()`	取消返回键监听	-
文件下载	`downloadFile(options)`	下载文件（支持进度回调）	✓
	`downloadWithCache(fileUrl, fileMd5, cacheTts, fileCacheKey?)`	下载并缓存文件，命中缓存直接返回本地路径	✓
文件操作	`fileExists(path)`	检查文件是否存在	✓
	`getFileMd5(path)`	获取文件 MD5	✓
	`deleteFile(path)`	删除文件或目录	✓
	`moveFile(src, dest)`	移动/重命名文件	✓
	`createDir(path)`	创建目录	✓
	`listDir(path)`	列出目录内容	✓
	`readFile(path)`	读取文本文件	✓
	`writeFile(path, content)`	写入文本文件	✓
ZIP	`unzipFile(zipPath, destPath)`	解压 ZIP 文件	✓
	`zipDir(sourcePath, zipPath)`	压缩目录为 ZIP	✓
登录	`getAuthProviders()`	获取支持的三方登录方式列表	✓
	`requestLogin(options)`	触发三方登录	✓
支付 `SuperSDK.pay.*`	`pay.purchase(payConfig)`	发起购买(唯一入口 · 聚合 createOrder→pay · 返回三态)	✓
	`pay.getProviders()`	探测宿主支持的支付方式列表	✓
	`pay.registerProvider(name, provider)`	注册 Provider(Web 收银台 / Native IAP override)	-
	`pay.restorePurchases(options)`	客户端恢复购买(F036 PurchaseResult[] · provider 可选实现)	✓
归因	`getAttribution(onlyFirst)`	获取归因数据	✓
Native Block	`nativeBlock.init()`	初始化，扫描静态 `<native-block>`	-
	`nativeBlock.create(options)`	动态创建原生组件	✓
	`nativeBlock.destroy(blockId)`	销毁指定组件	-
	`nativeBlock.destroyAll()`	销毁所有组件	-
	`nativeBlock.updatePositions()`	手动更新组件位置	-
响应编码	`getSuEncCapabilities()`	查询本端支持的 suenc codec	-
	`decodeSuEnc(encodedData, codec)`	解码 suenc 响应体	-