mirror of
https://github.com/Gongxh0901/kunpolibrary
synced 2025-04-19 18:08:42 +00:00
375 lines
13 KiB
TypeScript
375 lines
13 KiB
TypeScript
/**
|
||
* @Author: Gongxh
|
||
* @Date: 2025-04-11
|
||
* @Description: 字节跳动 API 类型定义
|
||
*/
|
||
|
||
declare namespace BytedanceMiniprogram {
|
||
type IAnyObject = Record<string, any>
|
||
|
||
type GeneralSuccessCallback = (res: GeneralSuccessResult) => void;
|
||
type GeneralFailCallback = (res: GeneralFailResult) => void;
|
||
type GeneralCompleteCallback = (res: any) => void;
|
||
|
||
interface GeneralSuccessResult {
|
||
errMsg: string;
|
||
}
|
||
|
||
interface GeneralFailCodeResult {
|
||
errCode: number;
|
||
errMsg: string;
|
||
}
|
||
|
||
interface GeneralFailResult {
|
||
errMsg: string;
|
||
errNo?: number;
|
||
}
|
||
|
||
/** 获取版本信息和环境变量 */
|
||
interface EnvInfo {
|
||
/** 小程序信息 */
|
||
microapp: {
|
||
/** 小程序版本号 */
|
||
mpVersion: string;
|
||
/** 小程序环境 */
|
||
envType: string;
|
||
/** 小程序appId */
|
||
appId: string;
|
||
};
|
||
/** 插件信息 */
|
||
plugin: Record<string, unknown>;
|
||
/** 通用参数 */
|
||
common: {
|
||
/** 用户数据存储的路径 */
|
||
USER_DATA_PATH: string;
|
||
/** 校验白名单属性中的appInfoLaunchFrom后返回额外信息 */
|
||
location: string | undefined;
|
||
launchFrom: string | undefined;
|
||
schema: string | undefined;
|
||
};
|
||
}
|
||
|
||
interface SystemInfo {
|
||
/** 操作系统版本 */
|
||
system: string;
|
||
/** 操作系统类型 */
|
||
platform: string;
|
||
/** 手机品牌 */
|
||
brand: string;
|
||
/** 手机型号 */
|
||
model: string;
|
||
/** 宿主 App 版本号 */
|
||
version: string;
|
||
/**
|
||
* 宿主 APP 名称
|
||
*
|
||
* - Toutiao 今日头条
|
||
* - Douyin 抖音（国内版)
|
||
* - news_article_lite 今日头条（极速版)
|
||
* - live_stream 火山小视频
|
||
* - XiGua 西瓜
|
||
* - PPX 皮皮虾
|
||
*/
|
||
appName: string;
|
||
/** 客户端基础库版本 */
|
||
SDKVersion: string;
|
||
/** 屏幕宽度 */
|
||
screenWidth: number;
|
||
/** 屏幕高度 */
|
||
screenHeight: number;
|
||
/** 可使用窗口宽度 */
|
||
windowWidth: number;
|
||
/** 可使用窗口高度 */
|
||
windowHeight: number;
|
||
/** 设备像素比 */
|
||
pixelRatio: number;
|
||
/** 状态栏的高度，单位 px */
|
||
statusBarHeight: number;
|
||
/** 在竖屏正方向下的安全区域 */
|
||
safeArea: {
|
||
/** 安全区域左上角横坐标 */
|
||
left: number;
|
||
/** 安全区域右下角横坐标 */
|
||
right: number;
|
||
/** 安全区域左上角纵坐标 */
|
||
top: number;
|
||
/** 安全区域右下角纵坐标 */
|
||
bottom: number;
|
||
/** 安全区域的宽度，单位逻辑像素 */
|
||
width: number;
|
||
/** 安全区域的高度，单位逻辑像素 */
|
||
height: number;
|
||
};
|
||
}
|
||
|
||
|
||
interface LaunchParams {
|
||
/**
|
||
* 小程序启动页面路径
|
||
* @version 1.12.0
|
||
*/
|
||
path: string;
|
||
/**
|
||
* 小程序启动场景值
|
||
* @version 1.12.0
|
||
*/
|
||
scene: string;
|
||
/**
|
||
* 小程序启动参数
|
||
* @version 1.12.0
|
||
*/
|
||
query: object;
|
||
/**
|
||
* 来源信息。从另一个小程序进入小程序时返回。否则返回 {}。
|
||
* @version 1.15.0
|
||
*/
|
||
referrerInfo: {
|
||
/** 来源小程序的 appId */
|
||
appId: string;
|
||
/** 来源小程序传过来的数据，场景值为 011009 或 011010 时支持。 */
|
||
extraData: object;
|
||
};
|
||
/**
|
||
* 唤起小程序页面的来源方式，10 表示用户点击小程序入口 schema，0 表示其它方式，比如前后台切换
|
||
* @version 1.90.0
|
||
*/
|
||
showFrom: number;
|
||
}
|
||
|
||
|
||
interface SocketTask {
|
||
/**
|
||
* 表示 Socket 连接状态 code
|
||
* 若由于参数错误导致未创建连接, 则为 undefined
|
||
*/
|
||
readonly readyState?: 0 | 1 | 2 | 3;
|
||
/** 表示 Socket 正在连接的常量 */
|
||
readonly CONNECTING: 0;
|
||
/** 表示 Socket 连接已经打开的常量 */
|
||
readonly OPEN: 1;
|
||
/** 表示 Socket 连接关闭中的常量 */
|
||
readonly CLOSING: 2;
|
||
/** 表示 Socket 连接已关闭的常量 */
|
||
readonly CLOSED: 3;
|
||
|
||
/**
|
||
* ### WebSocket 发送给服务端数据的方法
|
||
*/
|
||
send: (res: {
|
||
data: string | ArrayBuffer,
|
||
success?: GeneralSuccessCallback,
|
||
fail?: GeneralFailCallback,
|
||
complete?: GeneralCompleteCallback
|
||
}) => void;
|
||
|
||
/** ### 关闭 WebSocket 连接的方法。 */
|
||
close: (res: {
|
||
code?: number,
|
||
reason?: string,
|
||
success?: GeneralSuccessCallback,
|
||
fail?: GeneralFailCallback,
|
||
complete?: GeneralCompleteCallback
|
||
}) => void;
|
||
|
||
/**
|
||
* ### 监听 WebSocket 连接服务器成功的事件
|
||
* 表示 WebSocket 的状态变成 open，可以发送数据给服务器。
|
||
*/
|
||
onOpen: (
|
||
callback: (res: {
|
||
/** 连接服务器返回的 Response Header */
|
||
header: Record<string, unknown>;
|
||
/** 使用的网络传输层协议 */
|
||
protocolType: string;
|
||
/** websocket 类型 */
|
||
socketType: "ttnet" | "tradition";
|
||
}) => void
|
||
) => void;
|
||
|
||
/** 监听 WebSocket 与服务器的连接断开的事件 */
|
||
onClose: (
|
||
callback: (res: {
|
||
/** 使用的网络传输层协议 */
|
||
protocolType: string;
|
||
/** websocket 类型 */
|
||
socketType: string;
|
||
/** 错误信息 */
|
||
errMsg: string;
|
||
/** 关闭原因 */
|
||
reason: string;
|
||
/** 关闭 code */
|
||
code: string;
|
||
}) => void
|
||
) => void;
|
||
|
||
/** ### 监听 WebSocket 接收到服务器发送信息的事件。 */
|
||
onMessage: (
|
||
callback: (res: {
|
||
/** 接收到的服务器消息 */
|
||
data: string | ArrayBuffer;
|
||
/** websocket 使用的协议 */
|
||
protocolType: string;
|
||
/** websocket 类型 */
|
||
socketType: "ttnet" | "tradition";
|
||
}) => void
|
||
) => void;
|
||
|
||
/** ### 监听 WebSocket 发生错误的事件 */
|
||
onError: (
|
||
callback: (res: {
|
||
/** 错误信息 */
|
||
errMsg: string;
|
||
}) => void
|
||
) => void;
|
||
}
|
||
|
||
|
||
interface RewardedVideoAd {
|
||
/** 广告创建后默认是隐藏的，可以通过该方法显示广告 */
|
||
show: () => Promise<any>;
|
||
/** 当广告素材加载出现错误时，可以通过 load 方法手动加载 */
|
||
load: () => Promise<any>;
|
||
/** 绑定广告 load 事件的监听器 */
|
||
onLoad: (fn: Callback) => void;
|
||
/** 解除绑定 load 事件的监听器 */
|
||
offLoad: (fn: Callback) => void;
|
||
/** 绑定 error 事件的监听器 */
|
||
onError: (fn: (data: GeneralFailCodeResult) => void) => void;
|
||
/** 解除绑定 error 事件的监听器 */
|
||
onClose: (fn: (data: { isEnded: boolean, count?: number }) => void) => void;
|
||
/** 绑定 close 事件的监听器 */
|
||
offClose: (fn: Callback) => void;
|
||
}
|
||
|
||
interface CreateRewardedVideoAdOption {
|
||
/** 广告位 id */
|
||
adUnitId: string;
|
||
/** 是否开启再得广告模式（只支持安卓系统的抖音和抖音极速版） */
|
||
multiton?: boolean;
|
||
/**
|
||
* 再得广告的奖励文案，玩家每看完一个广告都会展示，如【再看1个获得xx】
|
||
* xx 即 multitonRewardMsg 中的文案，按顺序依次展示，单个文案最大长度为 7
|
||
* multiton 为 true 时必填
|
||
*/
|
||
multitonRewardMsg?: string[];
|
||
/**
|
||
* 额外观看广告的次数，合法的数据范围为 1-4，multiton 为 true 时必填
|
||
*/
|
||
multitonRewardTimes?: number;
|
||
/**
|
||
* 是否开启进度提醒，开启时广告文案为【再看N个获得xx】，关闭时为【 再看1个获得xx】。
|
||
* N 表示玩家当前还需额外观看广告的次数
|
||
*/
|
||
progressTip?: boolean;
|
||
}
|
||
|
||
interface IPaymentOptions {
|
||
/** 支付的类型, 目前仅为"game" */
|
||
mode: "game";
|
||
/** 环境配置，目前合法值仅为"0" */
|
||
env: 0;
|
||
/** 货币类型，目前合法值仅为"CNY" */
|
||
currencyType: "CNY";
|
||
/** 申请接入时的平台，目前仅为"android" */
|
||
platform: "android";
|
||
/**
|
||
* 金币购买数量，金币数量必须满足：金币数量*金币单价 = 限定价格等级
|
||
* goodType为游戏币场景时必传，其他场景不传
|
||
*/
|
||
buyQuantity?: number;
|
||
|
||
/**
|
||
* 游戏服务区id，开发者自定义。游戏不分大区则默认填写"1"。如果应用支持多角色，则角色 ID 接在分区 ID 后，用"_"连接
|
||
*/
|
||
zoneId?: string;
|
||
/**
|
||
* 游戏开发者自定义的唯一订单号，订单支付成功后通过服务端支付结果回调回传
|
||
* 必须具有唯一性，如果不传或重复传相同值，则会报错
|
||
*/
|
||
customId: string;
|
||
/** 游戏开发者自定义的其他信息，订单支付成功后通过服务端支付结果回调回传。字符串长度最大不能超过 256。 */
|
||
extraInfo?: string;
|
||
/** 支付场景 默认:0 */
|
||
goodType?: number;
|
||
/** goodType为道具直购场景时必传，代表道具现金价格，单位为【分】，如道具价格为0.1元，则回传10 */
|
||
orderAmount?: string;
|
||
/** goodType为道具直购场景时，代表道具名称，长度限制小于等于10个字符，用于区分道具类型 */
|
||
goodName?: string;
|
||
|
||
success?: (res: GeneralSuccessResult) => void;
|
||
fail?: (res: GeneralFailCodeResult) => void;
|
||
complete?: (res: any) => void;
|
||
}
|
||
|
||
interface IAwemeCustomerOptions {
|
||
/** 游戏开发者自定义的其他信息，订单支付成功后通过服务端支付结果回调回传。字符串长度最大不能超过 256。（强烈建议传入） */
|
||
extraInfo?: string;
|
||
/**
|
||
* 游戏服务区id，开发者自定义。游戏不分大区则默认填写"1"。如果应用支持多角色，则角色 ID 接在分区 ID 后，用"_"连接
|
||
*/
|
||
zoneId?: string;
|
||
|
||
/** 币种，目前仅为“DIAMOND” */
|
||
currencyType: "DIAMOND" | "CNY";
|
||
/**
|
||
* 金币购买数量，金币数量必须满足：金币数量*金币单价 = 限定价格等级
|
||
* goodType为游戏币场景时必传，其他场景不传
|
||
*/
|
||
buyQuantity?: number;
|
||
/** 支付场景 默认:0 */
|
||
goodType?: number;
|
||
/** goodType为道具直购场景时必传，代表道具现金价格，单位为【分】，如道具价格为0.1元，则回传10 */
|
||
orderAmount?: string;
|
||
/** goodType为道具直购场景时，代表道具名称，长度限制小于等于10个字符，用于区分道具类型 */
|
||
goodName?: string;
|
||
/**
|
||
* 游戏开发者自定义的唯一订单号，订单支付成功后通过服务端支付结果回调回传
|
||
* 必须具有唯一性，如果不传或重复传相同值，则会报错
|
||
*/
|
||
customId: string;
|
||
success?: (res: GeneralSuccessResult) => void;
|
||
fail?: (res: GeneralFailResult) => void;
|
||
complete?: (res: any) => void;
|
||
}
|
||
|
||
interface TT {
|
||
getEnvInfoSync(): EnvInfo;
|
||
getSystemInfoSync(): SystemInfo;
|
||
getLaunchOptionsSync(): LaunchParams;
|
||
exitMiniProgram(res: {
|
||
success?: GeneralSuccessCallback,
|
||
fail?: GeneralFailCallback,
|
||
complete?: GeneralCompleteCallback
|
||
}): void;
|
||
|
||
setClipboardData(res: {
|
||
data: string,
|
||
success?: GeneralSuccessCallback,
|
||
fail?: GeneralFailCallback,
|
||
complete?: GeneralCompleteCallback
|
||
}): void;
|
||
|
||
connectSocket(res: {
|
||
/** Socket 连接地址 */
|
||
url: string;
|
||
/** 请求头 */
|
||
header?: Record<string, string>;
|
||
/** 子协议 */
|
||
protocols?: string[];
|
||
success?: (res: { socketTaskId: number }) => void,
|
||
fail?: GeneralFailCallback,
|
||
complete?: GeneralCompleteCallback
|
||
}): SocketTask;
|
||
|
||
// requestMidasPayment(res: MidasPaymentOption): void;
|
||
|
||
createRewardedVideoAd(option: CreateRewardedVideoAdOption): RewardedVideoAd;
|
||
|
||
/** 支付 */
|
||
requestGamePayment(res: IPaymentOptions): void;
|
||
/** 发起抖音钻石支付 */
|
||
openAwemeCustomerService(res: IAwemeCustomerOptions): void;
|
||
}
|
||
|
||
}
|
||
declare const tt: BytedanceMiniprogram.TT |