blackBox 请直接透传服务端,不要在客户端缓存blackBox请注意,在贵司的 App 中集成小盾提供的 SDK 产品时:
复制 AI 提示词,粘贴到 Codex、Copilot、Claude Code 等AI 编码工具,即可自动生成代码,完成 TD SDK 集成
ohpm install @trustdecision/mobrisk在工程的 oh-package.json5 中设置三方包依赖:
{
"dependencies": {
"@trustdecision/mobrisk": "1.3.5"
}
}在工程的 module.json5 的 module 节点中补充以下 requestPermissions 配置:
"requestPermissions": [
{
"name": "ohos.permission.INTERNET"
},
{
"name": "ohos.permission.GET_NETWORK_INFO"
},
{
"name": "ohos.permission.GET_WIFI_INFO"
},
{
"name": "ohos.permission.STORE_PERSISTENT_DATA"
},
{
"name": "ohos.permission.APPROXIMATELY_LOCATION"
}
]initWithOptionspublic static async initWithOptions(context: Context, params: TDRiskOption): Promise<void>在用户同意隐私协议后执行以下代码:
import AbilityStage from "@ohos.app.ability.AbilityStage";
import { TDRisk, TDRiskOption } from "@trustdecision/mobrisk";
export default class MyAbilityStage extends AbilityStage {
async onCreate() {
const options: TDRiskOption = {
partnerCode: "请输入您的合作方编码", // 合作方(partnerCode),请填写partnerCode,不要填partnerKey
appKey: "请输入您的appKey", // 配置AppKey,请联系运营获取
initWithOptions 调用完成后再调用 getBlackBoxAsync / getBlackBoxblackBox,每次获取请直接调用对应方法blackBox,在异步回调完成后再按需同步获取/**
* 异步获取 blackbox
* @param priorityCache 是否优先返回缓存,默认 false
* false:等待本次数据上报完成后返回最新 blackbox
* true:发起数据上报后优先返回缓存中的 blackbox,可立即返回
*/
public static async getBlackBoxAsync(priorityCache: boolean = false): Promise<string>
/**
* 同步获取 blackbox,直接返回当前可用的 blackbox
*/
public首次及关键业务节点建议使用异步方式获取:
import { TDRisk } from "@trustdecision/mobrisk";
async function getBlackBox() {
const blackBox = await TDRisk.getBlackBoxAsync();
console.info("TD_TS", `async blackBox: ${blackBox}`);
}在首次异步获取完成后,可在业务节点按需同步获取:
import { TDRisk } from "@trustdecision/mobrisk";
function getBlackBox() {
const blackBox = TDRisk.getBlackBox();
console.info("TD_TS", `sync blackBox: ${blackBox}`);
}blackBoxblackBoxTD_TS: td sdk init successgetBlackBoxAsync() 返回结果通常为 26 固定长度的正常 blackBoxgetBlackBoxAsync() 返回结果长度可能明显增加,详情可参考 正常 blackBox 和降级 blackBox 的差异const version: string = TDRisk.getSDKVersion();options["disableBatteryInfo"] = true |
| batteryStatus、batteryLevelRatio、batteryPluggedType、batteryTechnology |
| disableCarrierInfo | 禁止采集运营商信息,默认允许 | options["disableCarrierInfo"] = true | simCountryIso、simCarrier、simState |
| disablePrivacyData | 禁止隐私相关信息,默认允许 | options["disablePrivacyData"] = true | screenResolution、deviceType、brand、marketName、batteryStatus、batteryLevelRatio、batteryPluggedType、batteryTechnology、totalStorage、availableStorage、networkType、networkNames、cellIp、wifiIp、vpnIp、simCountryIso、simCarrier、simState、latitude、longitude、altitude、gpsSwitch、bssid、ssid、odid |
| httpTimeOut | 网络请求回调的超时时间,单位毫秒,默认60000 | options["httpTimeOut"] = 60000 |
| customMessage | 自定义消息,SDK 支持透传和存储 | options["customMessage"] = "customMessage" |