tencent cloud

腾讯云超级应用服务

其它特性

下载
聚焦模式
字号
最后更新时间: 2026-05-29 10:10:26

设置小程序容器的主题

必须在小程序启动前设置主题:浅色模式、深色模式或使用系统设置。
API 说明:
Future<void> setTheme(MiniTheme theme)
使用示例:
_tcmppFlutterPlugin.setTheme(MiniTheme.dark);

设置小程序的本地化

必须在小程序启动前设置。
language:小程序的语言。应为 ISO 639 alpha-2 或 alpha-3 语言代码。
variant:任意值,用于表示本地语言的变体。
API 说明:
Future<void> setLocale(String language,
{String? region, String? variant})
使用示例:
_tcmppFlutterPlugin.setLocale("en", region: "us");

将小程序/flutter 页面置于前台

小程序和 flutter 页面进行相互跳转时使用
API 说明:
Future<void> moveMiniAppToFront(String appId) async {
return TcmppFlutterPlatform.instance.moveMiniAppToFront(appId);
}

Future<void> moveFlutterToFront() async {
return TcmppFlutterPlatform.instance.moveFlutterToFront();
}
使用示例:
_tcmppFlutterPlugin.moveMiniAppToFront("testAppId");

web-view 组件中特殊链接处理

如果 web-view 组件展示的网页中存在特殊的 URL 链接,例如 tcmpp://host/path 这种以自定义 scheme 开头的链接,宿主可以接管这些链接的跳转操作,并自定义跳转行为,需实现 TcmppPlatformEventHandler 中的 interceptWebViewUrl 方法。
实现方法中提供了小程序信息与加载的链接。如果开发者处理了链接跳转并返回 true,web-view 将不再处理该链接。如果返回 false,web-view 将按照正常逻辑处理该链接。
API 说明:
Future<bool> interceptWebViewUrl(AppInfo? appInfo, String url) async {
return false;
}
使用示例:
@override
Future<bool> interceptWebViewUrl(AppInfo? appInfo, String url) async {
print("SupperAppCustom interceptWebViewUrl:${appInfo?.appId} $url");
if (url.startsWith("tcmpp://")) {
/// 跳转自定义页面
return true;
}
return false;
}

获取 SDK 配置信息

获取 SDK 内部调试信息,如 appKey、隐私 API、SDK 版本等信息。
API 说明:
/// 从原生 SDK 中获取调试信息。
/// 返回一个包含配置和调试信息的映射,例如应用 ID、应用密钥、域名、SDK 版本等。
Future<Map<String, dynamic>> getDebugInfo() async {
return TcmppFlutterPlatform.instance.getDebugInfo();
}
使用示例:
final infoMap = await _tcmppFlutterPlugin.getDebugInfo();
final guid = (infoMap['GUID'] ?? "") as String;

开启测试广告

开发调试期间不能点自家真实广告,会被判作无效流量甚至封号。通过此接口可以设置 Google 提供的测试广告进行开发中调试。
API 说明:
/// 启用测试广告
/// [enable] - 是否启用测试广告
/// [rewardedUnitId] - 广告的奖励单元标识符
/// [bannerUnitId] - 广告的横幅单元标识符
Future<void> enableTestAd(bool enable, String rewardedUnitId,
String bannerUnitId) async {
return TcmppFlutterPlatform.instance.enableTestAd(
enable, rewardedUnitId, bannerUnitId);
}
使用示例:
_tcmppFlutterPlugin.enableTestAd(true, "testRewardedUnitId", "testBannerUnitId");


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈