【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告
控制台更新动态
Android SDK 更新动态
iOS SDK 更新动态
Flutter 更新动态
IDE 更新动态
基础库更新动态
//QBar 扫码扩展组件implementation 'com.tencent.tcmpp.android:mini_extra_qrcode:${version}' // 版本信息请参见 Android SDK 更新动态//ML Kit 扫码扩展组件implementation 'com.tencent.tcmpp.android:mini_extra_qrcode_mlkit:${version}' // 版本信息请参见 Android SDK 更新动态implementation 'com.google.mlkit:barcode-scanning:17.0.2'implementation 'com.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0'
API 名称 | 说明 |
wx.scanCode | 调起客户端扫码界面进行扫码 |
权限 | 描述 |
相机权限 | 需要申请相机权限用于扫码 |
文件读写权限 | 需要申请文件读写权限用于识别本地图片中的二维码 |
implementation 'com.tencent.tcmpp.android:mini_extra_map:${version}'// 版本信息请参见 Android SDK 更新动态implementation 'com.tencent.map:tencent-map-vector-sdk:5.9.0' //版本信息参见 腾讯地图文档implementation 'com.tencent.map:sdk-utilities:1.0.9'implementation 'com.tencent.map.geolocation:TencentLocationSdk-openplatform:7.6.1.3'
<application...<meta-dataandroid:name="TencentMapSDK"android:value="(YOUR_API_KEY)" />...</application>
API 名称 | 说明 |
地图 | 支持地图相关接口,包括地图展示,使用地图选择位置,查询 POI ,离线地图,自定义瓦片等 |
权限 | 描述 |
定位权限 | 需要使用定位权限用于显示地图定位 |
@Overridepublic MiniConfigData configData(Context context, int configType, JSONObject params) {if (configType == MiniConfigData.TYPE_OFFLINE_MAP) {MiniConfigData.OfflineMapConfig offlineMapConfig = new MiniConfigData.OfflineMapConfig();//设置是否启用离线地图功能,默认为false。可以根据业务需求设置为trueofflineMapConfig.enabled = true;return new MiniConfigData.Builder().offlineMapConfig(offlineMapConfig).build();}return new MiniConfigData.Builder().build();}
implementation 'com.tencent.tcmpp.android:mini_extra_google_map:${version}'//版本信息请参考 Android SDK 更新动态implementation 'com.google.android.gms:play-services-maps:18.1.0' //版本信息参见 谷歌地图文档(需要外网访问)implementation 'com.google.maps.android:android-maps-utils:2.3.0'
repositories {maven {url 'https://developer.huawei.com/repo/'}}implementation 'com.tencent.tcmpp.android:mini_extra_huawei_map:${version}'//版本信息请参考 Android SDK 更新动态implementation 'com.huawei.hms:maps:6.9.0.300' //版本信息参见华为地图文档implementation 'com.huawei.hms:maps-basic:6.9.0.300'implementation 'com.huawei.hms:site:6.5.1.300'
<application...<meta-dataandroid:name="com.google.android.geo.API_KEY"android:value="(YOUR_API_KEY)" />...</application>
<application...<meta-dataandroid:name="HuaweiApiKey"android:value="(YOUR_API_KEY)" />...</application>
API 名称 | 说明 |
地图 | 支持地图相关接口以及组件,包括地图展示,使用地图选择位置以及查询 POI 等 |
权限 | 描述 |
定位权限 | 需要使用定位权限用于显示地图定位 |
//直播组件支持库implementation 'com.tencent.tcmpp.android:mini_extra_trtc_live:${version}'//版本信息请参见 Android SDK 更新动态//如果仅是集成直播组件库,使用以下轻量依赖implementation 'com.tencent.liteav:LiteAVSDK_Live:latest.release' //版本信息请参见 腾讯云文档//如果集成直播组件库以及播放器移动端高级版库,使用以下全量依赖版本implementation 'com.tencent.liteav:LiteAVSDK_Professional_Player_Premium:latest.release //版本信息请参见 腾讯云文档
@ProxyService(proxy = MiniAppProxy.class)public class MiniAppProxyImpl extends BaseMiniAppProxyImpl {@Overridepublic MiniConfigData configData(Context context, int configType, JSONObject params) {if(configType == MiniConfigData.TYPE_LIVE) {//Live直播配置MiniConfigData.LiveConfig liveConfig = new MiniConfigData.LiveConfig();//下面的key和url仅可用于demoliveConfig.licenseKey = "";liveConfig.licenseUrl = "";return new MiniConfigData.Builder().liveConfig(liveConfig).build();}return null;}}
API 名称 | 说明 |
wx.createLivePusherContext | 创建直播推流端 Context |
LivePusherContext | 支持 LivePusherContext 相关接口 |
wx.createLivePlayerContext | 创建直播拉流端 Context |
LivePlayerContext | 支持 LivePlayerContext 相关接口 |
live-pusher | 推流标签 |
live-player | 播放标签 |
权限名称 | 描述 |
相机权限 | - |
录音权限 | - |
implementation 'com.tencent.tcmpp.android:mini_extra_lbs:${version}'//版本信息请参见 Android SDK 更新动态
API 名称 | 说明 |
位置信息 | 支持位置信息相关接口 |
罗盘 | 支持罗盘相关接口 |
加速计 | 支持加速计相关接口 |
设备方向 | 支持设备方向相关接口 |
陀螺仪 | 支持陀螺仪相关接口 |
权限 | 说明 |
定位 | 获取定位依赖定位权限 |
implementation 'com.tencent.tcmpp.android:mini_extra_bluetooth:${version}'//版本信息请参见 Android SDK 更新动态
API | 说明 |
蓝牙-通用 | 蓝牙通用接口 |
蓝牙-低功耗外围设备 | 外围设备相关接口 |
蓝牙-低功耗中心设备 | 中心设备相关接口 |
蓝牙-信标 | 蓝牙信标相关接口 |
权限 | 说明 |
蓝牙 | 操作蓝牙需要申请蓝牙权限 |
定位 | 蓝牙设备搜索依赖定位权限 |
implementation 'com.tencent.tcmpp.android:mini_extra_nfc:${version}'//版本信息请参见 Android SDK 更新动态
API 名称 | 说明 |
wx.getNFCAdapter | 获取 NFC 操作管理实例对象 |
NFCAdapter | 支持 NFCAdapter 相关接口 |
NFC 实例(NfcA、NfcB、NfcV、NfcF、Ndef、IsoDep、MifareUltralight、MifareClassic) | 支持 NFC 标签实例相关接口 |
权限名称 | 描述 |
NFC 权限 | 需要获取 NFC 权限 |
implementation 'com.tencent.tcmpp.android:mini_extra_soter:${version}'//版本信息请参见 Android SDK 更新动态
API名称 | 说明 |
wx.startSoterAuthentication | - |
wx.checkIsSupportSoterAuthentication | - |
wx.checkIsSoterEnrolledInDevice | - |
权限 | 描述 |
指纹访问 | 需要申请指纹访问权限 |
implementation 'com.tencent.tcmpp.android:mini_extra_clipboard:${version}'//版本信息请参见 Android SDK 更新动态
API名称 | 说明 |
wx.getClipboardData | - |
wx.setClipboardData | - |
权限 | 描述 |
剪贴板权限 | 需要申请剪贴板访问权限 |
implementation 'com.tencent.tcmpp.android:mini_extra_contact:${version}'//版本信息请参见 Android SDK 更新动态
API 名称 | 说明 |
wx.addPhoneContact | 添加联系人 |
wx.chooseContact | 选择联系人 |
权限 | 描述 |
联系人读写权限 | 需要申请联系人访问、写入权限 |
implementation 'com.tencent.tcmpp.android:mini_extra_pdf:${version}'//版本信息请参见 Android SDK 更新动态
API 名称 | 说明 |
wx.openDocument | 打开文档(仅支持PDF格式) |
implementation 'com.tencent.tcmpp.android:mini_extra_media_support:${version}'//版本信息请参见 Android SDK 更新动态
implementation 'com.tencent.tcmpp.android:mini_extra_media_support_lite:${version}'//版本信息请参见 Android SDK 更新动态
@ProxyService(proxy = MediaImageLoaderProxy.class) public class CustomMediaImageLoaderProxy implements MediaImageLoaderProxy { private GlideImageEngine glideImageEngine = new GlideImageEngine(); @Override public ImageEngine getCustomImageEngine() { return glideImageEngine; } static class GlideImageEngine implements ImageEngine { @Override public void loadPhoto(@NonNull Context context, @NonNull Uri uri, @NonNull ImageView imageView) { Glide.with(context).load(uri).transition(withCrossFade()).into(imageView); } @Override public void loadGifAsBitmap(@NonNull Context context, @NonNull Uri gifUri, @NonNull ImageView imageView) { Glide.with(context).asBitmap().load(gifUri).into(imageView); } @Override public void loadGif(@NonNull Context context, @NonNull Uri gifUri, @NonNull ImageView imageView) { Glide.with(context).asGif().load(gifUri).transition(withCrossFade()).into(imageView);
implementation 'com.tencent.tcmpp.android:mini_extra_mbengine:${version}'//版本信息请参见 Android SDK 更新动态
implementation 'com.tencent.tcmpp.android:mini_extra_admob:${version}'//版本信息请参见 Android SDK 更新动态
<activityandroid:name="com.google.android.gms.ads.AdActivity"android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"android:exported="false"android:taskAffinity=":admob"android:excludeFromRecents="true"android:multiprocess="true"android:theme="@android:style/Theme.Translucent"tools:ignore="MissingClass" />
修改字段 | 目的及影响 | 是否可移除 |
android:multiprocess="true" | 目的: 使 AdActivity 运行在调用方进程中,从而支持小程序进程使用 AdMob 广告。 影响: 该属性只影响子进程调用 AdMob 广告功能,主进程不影响。 | 否,移除后小程序及小游戏无法正常展示广告 |
android:taskAffinity=":AdMob" | 目的: AdMob 在 banner 广告点击时,增加了FLAG_ACTIVITY_NEW_TASK 标记,导致AdActivity被压入了 superapp 的主任务栈中,不在小程序任务栈,因此从跳转目标页面返回时,会先回到 superapp 主任务栈中,无法正常返回小程序页面。增加该属性后,可让 AdActivity 被压入独立的任务栈,因为独立任务栈中没有其他页面,所以返回时可以正常返回小程序页面 影响: 1. AdMob 在展示激励视频广告时,没有添加 FLAG_ACTIVITY_NEW_TASK 标记,因此激励视频广告不受影响 2. banner 广告跳转目标页面会有单独任务栈,用户可能通过最近任务列表切换任务,影响最终返回逻辑 | 可移除,但移除后 banner 广告目标页返回时,无法正常返回小程序页面 |
android:excludeFromRecents="true" | 目的: 因为 AdActivity 可能只是作为过渡页面,当 AdActivity 被压入新任务栈后,可能在最近任务列表中展示一个黑屏任务,点击无法正常切换,通过该属性可移除该黑屏任务的显示 影响: AdActivity 作为任务栈根页面的情况下,最近任务列表不显示该任务,部分场景可能存在 Activity 泄露 | 可移除,移除后有最近任务列表展示黑屏任务问题 |
//播放器移动端高级版组件支持库implementation 'com.tencent.tcmpp.android:mini_extra_video:${version}'//版本信息请参见 Android SDK 更新动态//如果仅是集成播放器移动端高级版组件库,使用以下轻量依赖implementation 'com.tencent.liteav:LiteAVSDK_Player_Premium:latest.release' //版本信息请参见 腾讯云文档//如果集成播放器移动端高级版组件库以及直播组件库,使用以下全量依赖版本implementation 'com.tencent.liteav:LiteAVSDK_Professional_Player_Premium:latest.release //版本信息请参见 腾讯云文档
@ProxyService(proxy = MiniAppProxy.class)public class MiniAppProxyImpl extends BaseMiniAppProxyImpl {@Overridepublic MiniConfigData configData(Context context, int configType, JSONObject params) {if(configType == MiniConfigData.TYPE_LIVE) {//video播放器移动端高级版配置MiniConfigData.LiveConfig liveConfig = new MiniConfigData.LiveConfig();//下面的key和url仅可用于demoliveConfig.licenseKey = "";liveConfig.licenseUrl = "";return new MiniConfigData.Builder().liveConfig(liveConfig).build();}return null;}}
API 名称 | 说明 |
is-drm | 是否为 DRM 类型视频源 |
provision-url | 证书提供商 URL |
license-url | 解密 Key URL |
-keep class com.tencent.liteav.** { *; }
<?xml version="1.0" encoding="utf-8"?><network-security-config><domain-config cleartextTrafficPermitted="true"><domain includeSubdomains="true">127.0.0.1</domain></domain-config></network-security-config>
<?xml version="1.0" encoding="utf-8"?><manifest ... ><application android:networkSecurityConfig="@xml/network_security_config"... >...</application></manifest>
implementation 'com.tencent.tcmpp.android:mini_extra_network:${version}'//版本信息请参见 Android SDK 更新动态
implementation 'com.tencent.tcmpp.android:mini_extra_wifi:${version}'//版本信息请参见 Android SDK 更新动态
API名称 | 说明 |
Wi-Fi |
权限 | 描述 |
读取与设置 Wi-Fi 状态权限 | 需要读取与设置 Wi-Fi 状态权限来管理 Wi-Fi |
读取与设置网络状态权限 | 需要读取与设置网络状态权限来管理 Wi-Fi |
地理位置权限 | 需要地理位置权限来扫描附近的 Wi-Fi |
implementation 'com.tencent.tcmpp.android:mini_extra_calendar:${version}'//版本信息请参见 Android SDK 更新动态
API名称 | 说明 |
addPhoneRepeatCalendar | 向系统日历添加重复事件 |
addPhoneCalendar | 向系统日历添加事件 |
权限 | 描述 |
日历读写权限 | 需要申请日历读写权限来向日历添加事件 |
// 短剧组件支持库implementation 'com.tencent.tcmpp.android:mini_extra_playlet:${version}' //版本信息请参见 Android SDK 更新动态implementation "com.tencent.tcmpp.android:TUIDramaPlayer:1.0.3"implementation 'com.tencent.liteav:LiteAVSDK_Professional_Player_Premium:latest.release //版本信息请参见 腾讯云文档
@ProxyService(proxy = MiniAppProxy.class)public class MiniAppProxyImpl extends BaseMiniAppProxyImpl {@Overridepublic MiniConfigData configData(Context context, int configType, JSONObject params) {if (configType == MiniConfigData.TYPE_PLAYLET) {//短剧配置MiniConfigData.PlayletConfig playletConfig = new MiniConfigData.PlayletConfig();//下面的key和url仅可用于demoplayletConfig.licenseKey = "";playletConfig.licenseUrl = "";return new MiniConfigData.Builder().playletConfig(playletConfig).build();}return new MiniConfigData.Builder().build();}}
-keep class com.tencent.liteav.** { *; }-keep class com.tencent.live2.** { *; }-keep class com.tencent.rtmp.** { *; }-keep class com.tencent.thumbplayer.** { *; }-keep class com.tencent.trtc.** { *; }-keep class com.tencent.ugc.** { *; }
文档反馈