概述

API

框架提供给开发者更多的JSAPI和OpenAPI能力,通过小程序可以为用户提供多样化便捷服务。

说明:

my.on 开头的 API 用来监听系统事件,接受一个 callback 函数作为参数。当该事件触发时,会调用 callback 函数,该 callback 函数可以传给对应 my.off 开头的 API 来解除监听关系,如果直接调用my.off 开头的 API 则为解除所有监听关系。例如

  1. Page({
  2. onLoad() {
  3. this.callback = this.callback.bind(this);
  4. my.onBLECharacteristicValueChange(this.callback);
  5. },
  6. onUnload() {
  7. // 页面卸载时解除监听
  8. my.offBLECharacteristicValueChange(this.callback);
  9. },
  10. callback(res) {
  11. console.log(res);
  12. },
  13. });

其他 API 接口都接受一个 object 作为参数。可以指定success(调用成功), fail(调用失败), complete(调用成功或失败)来接收接口调用结果。回调结果如无特殊说明,一般为一个对象,其中如果有 error/errorMessage 则表示调用失败。调用后返回值为一个 promise 对象。 例如

  1. my.httpRequest({
  2. url: '/x.htm',
  3. success:(res1) => {
  4. },
  5. }).then((res2) => {
  6. // res1 === res2
  7. },(res2) => {
  8. console.log(res.error, res.errorMessage);
  9. })

原文: https://docs.alipay.com/mini/api/