扩展 SDK

最近更新时间:2024-04-10 15:12:31

我的收藏
TCMPPSDK 引擎提供核心模块及扩展模块,方便使用者根据自己的情况进行接入。

扩展 SDK 接入及使用

扩展 SDK 是对核心 SDK 的补充,所以要使用扩展 SDK,也必须依赖核心 SDK。为了保证 SDK 的安全稳定性,将需要权限的 API 尽可能放到扩展 SDK,TCMPPSDK 引擎将 SDK 拆分为核心 SDK 与扩展 SDK,后者是前者的补充,因此使用扩展 SDK 也必须依赖核心 SDK。

TCMPPSDKExtMedia

TCMPPSDKExtMedia 提供 chooseMedia,chooseVideo,chooseImage 三个接口的默认实现,如果宿主 App 已经有对应能力,建议在开放接口中实现,如果需要使用 TMF 提供的多媒体选择插件,需要使用该插件。
使用方式:
pod 'TCMPPSDK'
pod 'TCMPPSDKExtMedia'

TCMPPSDKExtScanCode

TCMPPSDKExtScanCode 提供 wx.scanCode 的处理逻辑,如果宿主 App 本身已经有扫码识别能力,建议通过。
TMFMiniAppSDKDelegate.scanCode:(NSDictionary *)scanPrams navigationController:(UINavigationController *)navigationController completionHandler:(MACommonCallback)completionHandler;
对接已经正常使用的扫码模块,如果需要使用 TMF 提供的扫码功能,可以使用该插件。
使用方式:
pod 'ncnn'
pod 'TMFCodeDetector'
pod 'TCMPPSDK'
pod 'TCMPPSDKExtScanCode'

TCMPPSDKExtQMap

TCMPPSDKExtQMap 为中国大陆地区的用户提供腾讯地图 SDK 的相关能力。
使用方式
pod "TCMPPSDKExtQMap"
在腾讯地图开放平台申请 appkey 并在代码中进行设置:
[TMFAppletQMapComponent setQMapApiKey:@"XXXXXXXXXXX"];

TCMPPSDKExtLive

如果您需要使用直播组件(live-player 和 live-pusher)进行直播推、拉流相关场景的开发,需要添加如下 SDK 以支持直播组件相关的功能的实现。
pod "TCMPPSDKExtLive"
pod 'TXLiteAVSDK_Professional', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_Professional.podspec'
除了完成以上依赖的添加,您还需要实现 TMFMiniAppSDKDelegate 中的如下方法,提供直播组件需要的 LicenseUrl 和 LicenseKey,以完成直播组件的初始化信息配置;如果您未配置正确的 LicenseUrl 和 LicenseKey,会导致直播组件功能不可用。
说明:
LicenseUrl和LicenseKey的获取方式可以参考 《新增与续期 License 》 。
- (NSString *)setLiveLicenceURL {
return @"https://xxx.license";
}

- (NSString *)setLiveLicenceKey {
return @"xxx";
}

TCMPPExtAuthentication

TCMPPExtAuthentication 提供生物认证相关的能力。
集成方式:
pod "TCMPPExtAuthentication"
使用说明:
在 info.plist 文件中添加:
Privacy - Face ID Usage Description
API 列表:
api 名称
api 描述信息
checkIsSupportSoterAuthentication
获取本机支持的生物认证方式
checkIsSoterEnrolledInDevice
获取设备内是否录入如指纹等生物信息的接口
startSoterAuthentication
开始生物认证

TCMPPExtBLE

TCMPPExtBLE 提供低功耗蓝牙及信标相关的能力。
集成方式:
pod "TCMPPExtBLE"
使用说明:
在 info.plist 文件中添加:
Privacy - Bluetooth Always Usage Description
Privacy - Bluetooth Peripheral Usage Description
API列表:
api 名称
api 描述信息
蓝牙-通用
一系列的api
蓝牙-低功耗中心设备
一系列的api
蓝牙-低功耗外围设备
一系列的api
蓝牙-信标
一系列的api


TCMPPExtCalendar

TCMPPExtCalendar 提供日历相关的能力。
集成方式:
pod "TCMPPExtCalendar"
使用说明:
在info.plist文件中添加:
Privacy - Calendars Usage Description
Privacy - Reminders Usage Description
API列表:
api名称
api描述信息
addPhoneRepeatCalendar
向系统日历添加重复事件
addPhoneCalendar
向系统日历添加事件

TCMPPExtClipBoard

TCMPPExtClipBoard 提供系统剪切板相关的能力。
集成方式:
pod "TCMPPExtClipBoard"
API 列表:
api 名称
api 描述信息
setClipboardData
设置系统剪贴板的内容
getClipboardData
获取系统剪贴板的内容

TCMPPExtContact

TCMPPExtContact 提供日历相关的能力。
集成方式:
pod "TCMPPExtContact"
使用说明:
在 info.plist文件中添加:
Privacy - Contacts Usage Description
API 列表:
api 名称
api 描述信息
chooseContact
选择联系人
addPhoneContact
添加手机通讯录联系人

TCMPPExtLBS

TCMPPExtLBS 提供系统定位、系统地图、罗盘、加速计、设备方向、陀螺仪相关的能力。
集成方式:
pod "TCMPPExtLBS"
使用说明:
在 info.plist 文件中添加:
Privacy - Location Always and When In Use Usage Description
Privacy - Location Always Usage Description
Privacy - Location Usage Description
Privacy - Location When In Use Usage Description
Privacy - Motion Usage Description
API 列表:
api 名称
api 描述信息
定位
一系列的api
系统地图
一系列的api
罗盘、加速计、设备方向、陀螺仪
一系列的api

TCMPPExtMDNS

TCMPPExtMDNS 提供局域网通信的能力。
集成方式:
pod "TCMPPExtMDNS"
使用说明:
在info.plist 文件中添加:
Privacy - Local Network Usage Description
Privacy - Bonjour services
API 列表:
api 名称
api 描述信息
MDNS
一系列的 api

TCMPPExtNetwork

TCMPPExtNetwork 提供 TCP/UDP 通信的能力。
集成方式:
pod "TCMPPExtNetwork"
使用说明:
在 info.plist 文件中添加:
App Transport Security Settings
Allow Arbitrary Loads - YES
Privacy - Bonjour services
API 列表:
api 名称
api 描述信息
TCP
一系列的 api
UDP
一系列的 api

TCMPPExtMp3Encoder

TCMPPExtMp3Encoder 提供使用 RecorderManager 时保存为 mp3格式的能力。
集成方式:
pod "TCMPPExtMp3Encoder"
使用说明:
TCMPP 提供的录音保存成 mp3格式依赖 Lame 库,Lame 库开源协议基于GNU Library or Lesser General Public License version 2.0 (LGPLv2), GNU General Public License version 2.0 (GPLv2) 可参考:LAME,使用者可以根据需要集成。