抖音小程序基础之 目前提供哪些API(教程含源码)

小程序开发框架提供丰富的 字节跳动宿主 原生 API,可以方便的调起 字节跳动宿主 提供的能力,如获取系统信息等。详细介绍请参考 API 文档。

通常,在小程序 API 有以下几种类型:

  • 同步 API
  • 异步 API

同步 API

同步 API 的执行结果可以通过函数返回值直接获取,如果执行出错会抛出异常。

代码示例

try {
  tt.createVideoContext("video");
} catch (e) {
  console.error(e);
}

异步 API

大多数 API 都是异步 API,如 tt.request,tt.showToast 等。这类 API 接口通常都接受一个 Object 类型的参数,这个参数都支持按需指定以下字段来接收接口调用结果:

Object 参数说明

参数名类型必填说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
其他Any-接口定义的其他参数

回调函数的参数

successfailcomplete 函数调用时会传入一个 Object 类型参数,包含以下字段:

属性类型说明
errMsgstring错误信息,如果调用成功返回 ${apiName}:ok
errCodenumber错误码,仅部分 API 支持,具体含义请参考对应 API 文档,成功时为 0。
其他Any接口返回的其他数据

异步 API 的执行结果需要通过 Object 类型的参数中传入的对应回调函数获取。部分异步 API 也会有返回值,可以用来实现更丰富的功能,如 tt.request 等。

代码示例

let requestTask = tt.request({
  success(res) {
    console.log(res);
  },
});
requestTask.abort();

系列文章


未经授权禁止转载


更多技术交流请加入QQ群

群名称:抖音小程序开发
群 号:491016707

Logo

CSDN联合极客时间,共同打造面向开发者的精品内容学习社区,助力成长!

更多推荐