tencent cloud

扩展组件 SDK

PDF
聚焦模式
字号
最后更新时间: 2026-04-07 14:47:10
小程序的主 SDK(mini_core) 提供了小程序运行时基本能力,除 mini_core 以外,小程序 SDK 还提供如下的扩展组件, superapp 可以根据需要进行接入。

扫码扩展 SDK

组件说明:开发者小程序如果使用了小程序扫码能力,则需要添加如下 SDK 支持扫码功能。
集成方法:按照如下的方式添加扫码扩展库依赖。
SDK 版本:Android SDK 更新动态
注意:
QBar 扫码扩展组件与 ML Kit 扫码扩展组件只能二选一,否则扫码功能无效。
QBar 扫码扩展组件:
//QBar 扫码扩展组件
implementation 'com.tencent.tcmpp.android:mini_extra_qrcode:${version}' // 版本信息请参见 Android SDK 更新动态
ML Kit 扫码扩展组件:
//ML Kit 扫码扩展组件
implementation 'com.tencent.tcmpp.android:mini_extra_qrcode_mlkit:${version}' // 版本信息请参见 Android SDK 更新动态
implementation 'com.google.mlkit:barcode-scanning:17.3.0'
implementation 'com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1'
添加扫码扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
wx.scanCode
调起客户端扫码界面进行扫码
涉及权限:
权限
描述
相机权限
需要申请相机权限用于扫码
文件读写权限
需要申请文件读写权限用于识别本地图片中的二维码

腾讯定位地图扩展 SDK

组件说明:针对中国大陆地区 App 开发,开发者小程序如果使用了小程序地图能力,则需要添加如下 SDK 支持腾讯地图功能。
SDK 版本:Android SDK 更新动态
腾讯地图文档:腾讯地图文档
集成方法:按照如下的方式添加地图扩展库依赖:
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'
您需要在您的腾讯位置服务控制台配置项目,并获取访问腾讯地图服务所需要的 API 密钥,详细操作,请参见 开发指南
完成上述操作后,您需要在 Android 工程中配置您的 API 密钥。在 AndroidManifest.xml 文件中添加以下 meta-data,并将您的 API 密钥填入 (YOUR_API_KEY) 位置:
<application
...
<meta-data
android:name="TencentMapSDK"
android:value="(YOUR_API_KEY)" />
...
</application>
添加腾讯地图扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
地图
支持地图相关接口,包括地图展示,使用地图选择位置,查询 POI ,离线地图,自定义瓦片等
涉及权限:
权限
描述
定位权限
需要使用定位权限用于显示地图定位
离线地图功能,可以通过重写 BaseMiniAppProxyImpl 的 configData 方法,并拦截 configType 为 MiniConfigData.TYPE_OFFLINE_MAP 的方法实现自定义。
示例代码:
@Override
public MiniConfigData configData(Context context, int configType, JSONObject params) {
if (configType == MiniConfigData.TYPE_OFFLINE_MAP) {
MiniConfigData.OfflineMapConfig offlineMapConfig = new MiniConfigData.OfflineMapConfig();
//设置是否启用离线地图功能,默认为false。可以根据业务需求设置为true
offlineMapConfig.enabled = true;
return new MiniConfigData
.Builder()
.offlineMapConfig(offlineMapConfig)
.build();
}

return new MiniConfigData
.Builder()
.build();
}


Google 及华为定位地图扩展 SDK

组件说明:针对境外 App 开发,开发者小程序如果使用了小程序地图能力,需要添加如下 SDK 支持 Google Map 功能。
SDK 版本:Android SDK 更新动态
华为地图:华为地图文档
集成方法:按照如下的方式添加地图扩展库依赖:
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'
由于部分华为设备不支持内嵌 Google Map,可能导致地图无法显示。您可以额外接入 Petal Map 作为补充方案,小程序框架将在华为设备上优先使用 Petal Map。
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'
使用 Google Map 的情形,您需要在您的 Google Cloud Console 配置 Google Cloud 项目,并获取访问 Google 地图服务所需要的 API 密钥,具体操作步骤请参考在 Google Cloud Console 中进行设置以及使用 API 密钥
完成上述操作后,您需要在 Android 工程中配置您的 API 密钥。在 AndroidManifest.xml 文件中添加以下 meta-data,并将您的 API 密钥填入 (YOUR_API_KEY) 位置:
<application
...
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="(YOUR_API_KEY)" />
...
</application>
使用 Petal Map 的情形,您需要在您的华为管理控制台建立项目、开通地图以及位置服务并获取位置服务所使用的 API 密钥,具体操作步骤,请参见 配置 AppGallery Connect。然后按照 集成 HMS Core SDK 的引导下载“agconnect-services.json”文件至您的项目中并配置华为 AGC 插件。
您需要在 AndroidManifest.xml 文件中添加以下 meta-data,并将您的 API 密钥填入 (YOUR_API_KEY) 位置以正常使用华为的位置服务:
<application
...
<meta-data
android:name="HuaweiApiKey"
android:value="(YOUR_API_KEY)" />
...
</application>
注意:
出于安全考虑,建议您为位置服务单独申请 API 密钥。
添加 Google、华为地图扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
地图
支持地图相关接口以及组件,包括地图展示,使用地图选择位置以及查询 POI 等
涉及权限:
权限
描述
定位权限
需要使用定位权限用于显示地图定位

直播组件扩展 SDK

组件说明:如果您需要使用直播组件(live-player 和 live-pusher)进行直播推、拉流相关场景的开发,需要添加如下 SDK 以支持直播组件相关的功能的实现。
SDK 版本:Android SDK 更新动态
集成方法:添加直播组件依赖。
//直播组件支持库
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' //版本信息请参见 腾讯云文档
除了完成以上依赖的添加,您还需要重写实现 BaseMiniAppProxyImpl 的如下方法,提供直播组件需要的 LicenseUrl 和 LicenseKey,以完成直播组件的初始化信息配置;如果您未配置正确的 LicenseUrl 和 LicenseKey,会导致直播组件功能不可用。
说明:
LicenseUrl 和 LicenseKey 的获取方式可参见 新增与续期 License
@ProxyService(proxy = MiniAppProxy.class)
public class MiniAppProxyImpl extends BaseMiniAppProxyImpl {
@Override
public MiniConfigData configData(Context context, int configType, JSONObject params) {
if(configType == MiniConfigData.TYPE_LIVE) {
//Live直播配置
MiniConfigData.LiveConfig liveConfig = new MiniConfigData.LiveConfig();
//下面的key和url仅可用于demo
liveConfig.licenseKey = "";
liveConfig.licenseUrl = "";

return new MiniConfigData
.Builder()
.liveConfig(liveConfig)
.build();
}

return null;
}
}
添加直播扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
wx.createLivePusherContext
创建直播推流端 Context
LivePusherContext
支持 LivePusherContext 相关接口
wx.createLivePlayerContext
创建直播拉流端 Context
LivePlayerContext
支持 LivePlayerContext 相关接口
live-pusher
推流标签
live-player
播放标签
涉及权限如下:
权限名称
描述
相机权限
-
录音权限
-

LBS 扩展 SDK

组件说明:LBS 组件提供位置信息、罗盘、加速计、定位、设备方向相关的能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加 LBS 扩展库依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_lbs:${version}'//版本信息请参见 Android SDK 更新动态
添加 LBS 扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
位置信息
支持位置信息相关接口
罗盘
支持罗盘相关接口
加速计
支持加速计相关接口
设备方向
支持设备方向相关接口
陀螺仪
支持陀螺仪相关接口
LBS 扩展 SDK 涉及权限如下:
权限
说明
定位
获取定位依赖定位权限

蓝牙扩展 SDK

组件说明:添加蓝牙扩展库之后,即可使用蓝牙相关的 API。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加蓝牙扩展库依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_bluetooth:${version}'//版本信息请参见 Android SDK 更新动态
添加 LBS 扩展 SDK 后,增加支持的小程序 API 列表如下:
API
说明
蓝牙-通用
蓝牙通用接口
蓝牙-低功耗外围设备
外围设备相关接口
蓝牙-低功耗中心设备
中心设备相关接口
蓝牙-信标
蓝牙信标相关接口
蓝牙扩展 SDK 涉及权限如下:
权限
说明
蓝牙
操作蓝牙需要申请蓝牙权限
定位
蓝牙设备搜索依赖定位权限

NFC 扩展 SDK

组件说明:添加 NFC 扩展 SDK,能够实现 NFC 读写相关的能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加 NFC 扩展 SDK 依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_nfc:${version}'//版本信息请参见 Android SDK 更新动态
添加 NFC 扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
wx.getNFCAdapter
获取 NFC 操作管理实例对象
NFCAdapter
支持 NFCAdapter 相关接口
NFC 实例(NfcA、NfcB、NfcV、NfcF、Ndef、IsoDep、MifareUltralight、MifareClassic)
支持 NFC 标签实例相关接口
所涉及权限:
权限名称
描述
NFC 权限
需要获取 NFC 权限

生物认证扩展 SDK

组件说明:生物认证扩展 SDK 提供设备指纹、人脸识别相关的能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加生物认证扩展库依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_soter:${version}'//版本信息请参见 Android SDK 更新动态
添加生物认证扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
wx.startSoterAuthentication
-
wx.checkIsSupportSoterAuthentication
-
wx.checkIsSoterEnrolledInDevice
-
涉及权限:
权限
描述
指纹访问
需要申请指纹访问权限

剪贴板扩展 SDK

组件说明:提供剪贴板访问的能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加扩展库依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_clipboard:${version}'//版本信息请参见 Android SDK 更新动态
添加 LBS 扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
wx.getClipboardData
-
wx.setClipboardData
-
涉及权限:
权限
描述
剪贴板权限
需要申请剪贴板访问权限

通讯录扩展 SDK

组件说明:提供联系人访问相关能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加扩展库依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_contact:${version}'//版本信息请参见 Android SDK 更新动态
添加通讯录扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
wx.addPhoneContact
添加联系人
wx.chooseContact
选择联系人
涉及权限:
权限
描述
联系人读写权限
需要申请联系人访问、写入权限

PDF 扩展 SDK

组件说明:提供 PDF 文档打开能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加扩展库依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_pdf:${version}'//版本信息请参见 Android SDK 更新动态
添加 PDF 扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
wx.openDocument
打开文档(仅支持 PDF 格式)

媒体扩展 SDK

组件说明:提供 chooseMedia、previewMedia 的默认实现。从 1.5.9 版本起新增了 lite 版本, 使用系统图片选择器,以达到解除 READ_MEDIA_IMAGES 和 READ_MEDIA_VIDEO 权限的目的,lite 版与非 lite 版本是互斥的,同时集成会有编译错误,请根据需要选择相应版本。
SDK 版本:Android SDK 更新动态
非 lite 版本:
非 lite 版本媒体选择功能为 SDK 自定义实现,依赖系统媒体选择权限,具备图片与视频预览功能,不过 Google Play 对媒体权限有较严格的政策,如非必要建议选择 lite 版本,详情请参考:Google Play's Photo and Video Permissions policy
implementation 'com.tencent.tcmpp.android:mini_extra_media_support:${version}'//版本信息请参见 Android SDK 更新动态
lite 版本:
lite 版本媒体选择直接调用的是系统媒体选择功能,UI 与交互与系统一致, 无需依赖媒体权限。
implementation 'com.tencent.tcmpp.android:mini_extra_media_support_lite:${version}'//版本信息请参见 Android SDK 更新动态
实现 MediaImageLoaderProxy 代理,使用自定义的图片加载实现,用于 mini_extra_media_support 库的图片加载。
说明:
可以通过实现 MediaChooseJsProxy 代理,实现自定义的 chooseMedia 逻辑。
@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);

小游戏扩展 SDK

组件说明:提供小游戏引擎实现
集成方法:按照如下的方式添加扩展库依赖
SDK 版本:Android SDK 更新动态
implementation 'com.tencent.tcmpp.android:mini_extra_mbengine:${version}'//版本信息请参见 Android SDK 更新动态
添加扩展库后,支持小游戏,小游戏 API 请参考 API 概览
注意:
Unity 小游戏中短音频播放通过 webaudio 来实现,因此如果您需要支持 Unity 小游戏则建议您同时集成 webaudio 扩展库,否则 Unity 小游戏音频播放会有问题。

WebAudio 扩展 SDK

组件说明:提供小游戏 webaudio 实现
集成方法:按照如下的方式添加扩展库依赖
SDK 版本:Android SDK 更新动态
implementation 'com.tencent.tcmpp.android:mini_extra_webaudio:${version}'//版本信息请参见 Android SDK 更新动态

Google 广告扩展 SDK

组件说明:提供 Google AdMob 广告加载能力
集成方法:按照如下的方式添加扩展库依赖:
SDK 版本:Android SDK 更新动态
implementation 'com.tencent.tcmpp.android:mini_extra_admob:${version}'//版本信息请参见 Android SDK 更新动态
说明:
该功能依赖 AdMob,请先按照官方文档接入 AdMob
小程序框架是以多任务多进程的架构运行的,小程序会运行在独立的进程中,由于 AdMob 默认不支持多进程,广告扩展库通过修改 AdMob AdActivity 声明的方式进行了适配修改,详情如下:
<activity
android: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 泄露
可移除,移除后有最近任务列表展示黑屏任务问题

播放器移动端高级版组件扩展 SDK

组件说明:如果您需要播放 DRM 加密视频,需 superapp 集成此扩展库并在小程序中配置相关属性。
说明:
默认预加载大小2 MB。
视频自动播放场景下默认缓冲大小为30s*视频码率。
视频非自动播放场景下优先加载默认预加载值(2 MB),后续默认缓冲值5 MB。
SDK 版本:Android SDK 更新动态
集成方法:添加播放器移动端高级版组件依赖。
//播放器移动端高级版组件支持库
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' //版本信息请参见 腾讯云文档
除了完成以上依赖的添加,您还需要重写实现 BaseMiniAppProxyImpl 的如下方法,提供播放器移动端高级版组件需要的 LicenseURL 和 LicenseKey,以完成播放器移动端高级版组件的初始化信息配置;如果您未配置正确的 LicenseUrl 和 LicenseKey,会导致播放器移动端高级版组件功能不可用。(直播与播放器移动端高级版使用相同方式配置)
说明:
LicenseURL 和 LicenseKey 的获取方式可参见 新增与续期 License。(需购买支持 DRM 能力版本)
@ProxyService(proxy = MiniAppProxy.class)
public class MiniAppProxyImpl extends BaseMiniAppProxyImpl {
@Override
public MiniConfigData configData(Context context, int configType, JSONObject params) {
if(configType == MiniConfigData.TYPE_LIVE) {
//video播放器移动端高级版配置
MiniConfigData.LiveConfig liveConfig = new MiniConfigData.LiveConfig();
//下面的key和url仅可用于demo
liveConfig.licenseKey = "";
liveConfig.licenseUrl = "";

return new MiniConfigData
.Builder()
.liveConfig(liveConfig)
.build();
}

return null;
}
}
添加播放器移动端高级版扩展 SDK 后,增加支持的小程序 video 组件属性列表如下:
API 名称
说明
is-drm
是否为 DRM 类型视频源
provision-url
证书提供商 URL
license-url
解密 Key URL
涉及权限如下:
网络权限、存储权限
设置混淆规则:
在 proguard-rules.pro 文件中,将 LiteAVSDK 相关类加入不混淆名单:
-keep class com.tencent.liteav.** { *; }
网络安全配置允许 App 发送 HTTP 请求
出于安全考虑,从 Android P(Android 9.0) 开始,Google 要求 App 的请求都使用加密链接。播放器 SDK 会启动一个 local server 代理 HTTP 请求,如果您的应用 targetSdkVersion 大于或等于28,可以通过 网络安全配置 来开启允许向127.0.0.1发送 HTTP 请求。 否则播放时将出现 "java.io.IOException: Cleartext HTTP traffic to 127.0.0.1 not permitted" 错误, 导致无法播放视频。配置步骤如下:
在项目中新建 res/xml/network_security_config.xml 文件,设置网络安全性配置。
<?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>
在 AndroidManifest.xml 文件下的 application 标签增加以下属性。
<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
<application android:networkSecurityConfig="@xml/network_security_config"
... >
...
</application>
</manifest>

网络扩展 SDK

组件说明:网络扩展 SDK 提供 TCP/UDP 通信的能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加网络扩展 SDK 依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_network:${version}'//版本信息请参见 Android SDK 更新动态
添加网络扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
TCP
一系列的 API TCP 通信
UDP
一系列的 API UDP 通信

Wi-Fi 扩展 SDK

组件说明:Wi-Fi 扩展 SDK 提供 Wi-Fi 管理相关能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加 Wi-Fi 扩展 SDK 依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_wifi:${version}'//版本信息请参见 Android SDK 更新动态
添加 Wi-Fi 扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
Wi-Fi
一系列的 API Wi-Fi 管理
权限
描述
读取与设置 Wi-Fi 状态权限
需要读取与设置 Wi-Fi 状态权限来管理 Wi-Fi
读取与设置网络状态权限
需要读取与设置网络状态权限来管理 Wi-Fi
地理位置权限
需要地理位置权限来扫描附近的 Wi-Fi

日历扩展 SDK

组件说明:日历扩展 SDK 提供日历相关能力。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加日历扩展 SDK 依赖。
implementation 'com.tencent.tcmpp.android:mini_extra_calendar:${version}'//版本信息请参见 Android SDK 更新动态
添加日历扩展 SDK 后,增加支持的小程序 API 列表如下:
API 名称
说明
addPhoneRepeatCalendar
向系统日历添加重复事件
addPhoneCalendar
向系统日历添加事件
涉及权限:
权限
描述
日历读写权限
需要申请日历读写权限来向日历添加事件

短剧扩展 SDK

组件说明:为保障客户 superapp 内短剧内容体验的一致性,并降低接入方的开发成本,我们提供了一套功能完备、体验流畅的短剧播放器 UI 组件和 API。SDK 将负责短剧播放相关的 UI 渲染与交互逻辑,而接入方(开发者)则专注于其自身的业务逻辑,如短剧内容、解锁状态等。
SDK 版本:Android SDK 更新动态
集成方法:按照如下的方式添加短剧扩展 SDK 依赖。
// 短剧组件支持库
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'
除了完成以上依赖的添加,您还需要做如下配置:
1. 重写实现 BaseMiniAppProxyImpl 的如下方法,提供短剧组件需要的 LicenseUrl 和 LicenseKey,以完成短剧组件的初始化信息配置;如果您未配置正确的 LicenseUrl 和 LicenseKey,会导致短剧组件功能不可用。
说明:
LicenseUrl 和 LicenseKey 的获取方式可参见 新增与续期 License

@ProxyService(proxy = MiniAppProxy.class)
public class MiniAppProxyImpl extends BaseMiniAppProxyImpl {
@Override
public MiniConfigData configData(Context context, int configType, JSONObject params) {
if (configType == MiniConfigData.TYPE_PLAYLET) {
//短剧配置
MiniConfigData.PlayletConfig playletConfig = new MiniConfigData.PlayletConfig();
//下面的key和url仅可用于demo
playletConfig.licenseKey = "";
playletConfig.licenseUrl = "";

return new MiniConfigData
.Builder()
.playletConfig(playletConfig)
.build();
}

return new MiniConfigData
.Builder()
.build();
}
}
2. 配置混淆策略,在混淆策略中新增这几条。如果没有配置会导致短剧组件功能不可用。
-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.** { *; }


帮助和支持

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

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

文档反馈