@dcloudio/uni-app-x 0.7.21 → 0.7.22

package/types/uni/uts-plugin-api/lib/uni-canvas/utssdk/interface.d.ts

@@ -1,264 +1,332 @@
-export type CreateCanvasContextAsyncSuccessCallback = (context: CanvasContext) => void
-export type CreateCanvasContextAsyncFailCallback = (error: UniError) => void
-export type CreateCanvasContextAsyncCompleteCallback = () => void
-
-// #ifdef WEB
-export type CanvasContextToBlobCallback = (blob: Blob) => void
-// #endif
-
-export interface CanvasContext {
-  getContext(type: '2d'): CanvasRenderingContext2D | null
-
-// #ifdef WEB
-  /**
-   * 创造 Blob 对象
-   * @uniPlatform {
-   *  "app": {
-   *    "android": {
-   *        "osVer": "5.0",
-   *        "uniVer": "x",
-   *        "unixVer": "x"
-   *      },
-   *      "ios": {
-   *          "osVer": "10.0",
-   *          "uniVer": "x",
-   *          "unixVer": "x"
-   *      }
-   *  },
-   *  "web": {
-   *      "uniVer": "x",
-   *      "unixVer": "4.25"
-   *  }
-   * }
-   */
-  toBlob(callback: CanvasContextToBlobCallback, type?: string, quality?: number): void
-  // #endif
-  /**
-   * 返回一个包含图片展示的 data URI
-   * @uniPlatform {
-   *  "app": {
-   *    "android": {
-   *        "osVer": "5.0",
-   *        "uniVer": "x",
-   *        "unixVer": "4.25"
-   *      },
-   *      "ios": {
-   *          "osVer": "10.0",
-   *          "uniVer": "x",
-   *          "unixVer": "4.25"
-   *      }
-   *  },
-   *  "web": {
-   *      "uniVer": "x",
-   *      "unixVer": "4.25"
-   *  }
-   * }
-   */
-  toDataURL(): string
-  /**
-   * 返回一个包含图片展示的 data URI
-   * @uniPlatform {
-   *  "app": {
-   *    "android": {
-   *        "osVer": "5.0",
-   *        "uniVer": "x",
-   *        "unixVer": "4.25"
-   *      },
-   *      "ios": {
-   *          "osVer": "10.0",
-   *          "uniVer": "x",
-   *          "unixVer": "4.25"
-   *      }
-   *  },
-   *  "web": {
-   *      "uniVer": "x",
-   *      "unixVer": "4.25"
-   *  }
-   * }
-   */
-  toDataURL(type: string): string
-  /**
-   * 返回一个包含图片展示的 data URI
-   * @uniPlatform {
-   *  "app": {
-   *    "android": {
-   *        "osVer": "5.0",
-   *        "uniVer": "x",
-   *        "unixVer": "4.25"
-   *      },
-   *      "ios": {
-   *          "osVer": "10.0",
-   *          "uniVer": "x",
-   *          "unixVer": "4.25"
-   *      }
-   *  },
-   *  "web": {
-   *      "uniVer": "x",
-   *      "unixVer": "4.25"
-   *  }
-   * }
-   */
-  toDataURL(type: string, encoderOptions: any): string
-  /**
-   * 返回一个包含图片展示的 data URI
-   * @uniPlatform {
-   *  "app": {
-   *    "android": {
-   *        "osVer": "5.0",
-   *        "uniVer": "x",
-   *        "unixVer": "4.25"
-   *      },
-   *      "ios": {
-   *          "osVer": "10.0",
-   *          "uniVer": "x",
-   *          "unixVer": "4.25"
-   *      }
-   *  },
-   *  "web": {
-   *      "uniVer": "x",
-   *      "unixVer": "4.25"
-   *  }
-   * }
-   */
-  createImage(): Image
-}
-
-export type CreateCanvasContextAsyncOptions = {
-    /**
-     * canvas 元素的 id 属性
-     * @uniPlatform {
-     *  "app": {
-     *    "android": {
-     *        "osVer": "5.0",
-     *        "uniVer": "x",
-     *        "unixVer": "4.25"
-     *      },
-     *      "ios": {
-     *          "osVer": "10.0",
-     *          "uniVer": "x",
-     *          "unixVer": "4.25"
-     *      }
-     *  },
-     *  "web": {
-     *      "uniVer": "x",
-     *      "unixVer": "4.25"
-     *  }
-     * }
-     */
-    id: string.IDString
-    /**
-     * 组件或页面实例，限定在什么范围内查找id
-     * @uniPlatform {
-     *  "app": {
-     *    "android": {
-     *        "osVer": "5.0",
-     *        "uniVer": "x",
-     *        "unixVer": "4.25"
-     *      },
-     *      "ios": {
-     *          "osVer": "10.0",
-     *          "uniVer": "x",
-     *          "unixVer": "4.25"
-     *      }
-     *  },
-     *  "web": {
-     *      "uniVer": "x",
-     *      "unixVer": "4.25"
-     *  }
-     * }
-     */
-    component?: ComponentPublicInstance
-    /**
-     * 接口调用成功的回调函数
-     * @uniPlatform {
-     *  "app": {
-     *    "android": {
-     *        "osVer": "5.0",
-     *        "uniVer": "x",
-     *        "unixVer": "4.25"
-     *      },
-     *      "ios": {
-     *          "osVer": "10.0",
-     *          "uniVer": "x",
-     *          "unixVer": "4.25"
-     *      }
-     *  },
-     *  "web": {
-     *      "uniVer": "x",
-     *      "unixVer": "4.25"
-     *  }
-     * }
-     */
-    success?: CreateCanvasContextAsyncSuccessCallback
-    /**
-     * 接口调用失败的回调函数
-     * @uniPlatform {
-     *  "app": {
-     *    "android": {
-     *        "osVer": "5.0",
-     *        "uniVer": "x",
-     *        "unixVer": "4.25"
-     *      },
-     *      "ios": {
-     *          "osVer": "10.0",
-     *          "uniVer": "x",
-     *          "unixVer": "4.25"
-     *      }
-     *  },
-     *  "web": {
-     *      "uniVer": "x",
-     *      "unixVer": "4.25"
-     *  }
-     * }
-     */
-    fail?: CreateCanvasContextAsyncFailCallback
-    /**
-     * 接口调用结束的回调函数（调用成功、失败都会执行）
-     * @uniPlatform {
-     *  "app": {
-     *    "android": {
-     *        "osVer": "5.0",
-     *        "uniVer": "x",
-     *        "unixVer": "4.25"
-     *      },
-     *      "ios": {
-     *          "osVer": "10.0",
-     *          "uniVer": "x",
-     *          "unixVer": "4.25"
-     *      }
-     *  },
-     *  "web": {
-     *      "uniVer": "√",
-     *      "unixVer": "4.25"
-     *  }
-     * }
-     */
-    complete?: CreateCanvasContextAsyncCompleteCallback
-}
-
-export interface Uni {
-  /**
-   * 获取CanvasContext对象实例
-   *
-   * @tutorial-uni-app-x https://doc.dcloud.net.cn/uni-app-x/api/createCanvasContextAsync.html
-   * @uniPlatform {
-   *  "app": {
-   *    "android": {
-   *      "osVer": "5.0",
-   *      "uniVer": "x",
-   *      "unixVer": "4.25"
-   *    },
-   *    "ios": {
-   *      "osVer": "12.0",
-   *      "uniVer": "x",
-   *      "unixVer": "4.25"
-   *    }
-   *  },
-   *  "web": {
-   *    "uniVer": "x",
-   *    "unixVer": "4.25"
-   *  }
-   * }
-   */
-  createCanvasContextAsync(options: CreateCanvasContextAsyncOptions): void
-}
+export type CreateCanvasContextAsyncSuccessCallback = (context: CanvasContext) => void
+export type CreateCanvasContextAsyncFailCallback = (error: UniError) => void
+export type CreateCanvasContextAsyncCompleteCallback = () => void
+
+export type UniRequestAnimationFrameCallback = (task: number) => void
+
+// #ifdef WEB
+export type CanvasContextToBlobCallback = (blob: Blob) => void
+// #endif
+
+export interface CanvasContext {
+  getContext(type: '2d'): CanvasRenderingContext2D | null
+
+  // #ifdef WEB
+  /**
+   * 创造 Blob 对象
+   * @uniPlatform {
+   *  "app": {
+   *    "android": {
+   *        "osVer": "5.0",
+   *        "uniVer": "x",
+   *        "unixVer": "x"
+   *      },
+   *      "ios": {
+   *          "osVer": "10.0",
+   *          "uniVer": "x",
+   *          "unixVer": "x"
+   *      }
+   *  },
+   *  "web": {
+   *      "uniVer": "x",
+   *      "unixVer": "4.25"
+   *  }
+   * }
+   */
+  toBlob(callback: CanvasContextToBlobCallback, type?: string, quality?: number): void
+  // #endif
+  /**
+   * 返回一个包含图片展示的 data URI
+   * @uniPlatform {
+   *  "app": {
+   *    "android": {
+   *        "osVer": "5.0",
+   *        "uniVer": "x",
+   *        "unixVer": "4.25"
+   *      },
+   *      "ios": {
+   *          "osVer": "10.0",
+   *          "uniVer": "x",
+   *          "unixVer": "4.25"
+   *      }
+   *  },
+   *  "web": {
+   *      "uniVer": "x",
+   *      "unixVer": "4.25"
+   *  }
+   * }
+   */
+  toDataURL(): string
+  /**
+   * 返回一个包含图片展示的 data URI
+   * @uniPlatform {
+   *  "app": {
+   *    "android": {
+   *        "osVer": "5.0",
+   *        "uniVer": "x",
+   *        "unixVer": "4.25"
+   *      },
+   *      "ios": {
+   *          "osVer": "10.0",
+   *          "uniVer": "x",
+   *          "unixVer": "4.25"
+   *      }
+   *  },
+   *  "web": {
+   *      "uniVer": "x",
+   *      "unixVer": "4.25"
+   *  }
+   * }
+   */
+  toDataURL(type: string): string
+  /**
+   * 返回一个包含图片展示的 data URI
+   * @uniPlatform {
+   *  "app": {
+   *    "android": {
+   *        "osVer": "5.0",
+   *        "uniVer": "x",
+   *        "unixVer": "4.25"
+   *      },
+   *      "ios": {
+   *          "osVer": "10.0",
+   *          "uniVer": "x",
+   *          "unixVer": "4.25"
+   *      }
+   *  },
+   *  "web": {
+   *      "uniVer": "x",
+   *      "unixVer": "4.25"
+   *  }
+   * }
+   */
+  toDataURL(type: string, encoderOptions: any): string
+  /**
+   * 返回一个包含图片展示的 data URI
+   * @uniPlatform {
+   *  "app": {
+   *    "android": {
+   *        "osVer": "5.0",
+   *        "uniVer": "x",
+   *        "unixVer": "4.25"
+   *      },
+   *      "ios": {
+   *          "osVer": "10.0",
+   *          "uniVer": "x",
+   *          "unixVer": "4.25"
+   *      }
+   *  },
+   *  "web": {
+   *      "uniVer": "x",
+   *      "unixVer": "4.25"
+   *  }
+   * }
+   */
+  createImage(): Image
+  /**
+   * 返回一个包含图片展示的 data URI
+   * @uniPlatform {
+   *  "app": {
+   *    "android": {
+   *        "osVer": "5.0",
+   *        "uniVer": "x",
+   *        "unixVer": "4.25"
+   *      },
+   *      "ios": {
+   *          "osVer": "10.0",
+   *          "uniVer": "x",
+   *          "unixVer": "4.25"
+   *      }
+   *  },
+   *  "web": {
+   *      "uniVer": "x",
+   *      "unixVer": "4.25"
+   *  }
+   * }
+   */
+  createPath2D(): Path2D
+  /**
+   * 在下一次重绘之前，调用用户提供的回调函数
+   * @uniPlatform {
+   *   "app": {
+   *     "android": {
+   *       "osVer": "5.0",
+   *       "uniVer": "x",
+   *       "unixVer": "4.25"
+   *     },
+   *     "ios": {
+   *       "osVer": "12.0",
+   *       "uniVer": "x",
+   *       "unixVer": "4.25"
+   *     }
+   *   },
+   *   "web": {
+   *     "uniVer": "x",
+   *     "unixVer": "4.25"
+   *   }
+   * }
+   */
+  requestAnimationFrame(callback: UniRequestAnimationFrameCallback): number;
+  /**
+   * 取消一个先前通过调用 uni.requestAnimationFrame() 方法添加到计划中的动画帧请求
+   * @uniPlatform {
+   *   "app": {
+   *     "android": {
+   *       "osVer": "5.0",
+   *       "uniVer": "x",
+   *       "unixVer": "4.25"
+   *     },
+   *     "ios": {
+   *       "osVer": "12.0",
+   *       "uniVer": "x",
+   *       "unixVer": "4.25"
+   *     }
+   *   },
+   *   "web": {
+   *     "uniVer": "x",
+   *     "unixVer": "4.25"
+   *   }
+   * }
+   */
+  cancelAnimationFrame(taskId: number): void;
+}
+
+export type CreateCanvasContextAsyncOptions = {
+    /**
+     * canvas 元素的 id 属性
+     * @uniPlatform {
+     *  "app": {
+     *    "android": {
+     *        "osVer": "5.0",
+     *        "uniVer": "x",
+     *        "unixVer": "4.25"
+     *      },
+     *      "ios": {
+     *          "osVer": "10.0",
+     *          "uniVer": "x",
+     *          "unixVer": "4.25"
+     *      }
+     *  },
+     *  "web": {
+     *      "uniVer": "x",
+     *      "unixVer": "4.25"
+     *  }
+     * }
+     */
+    id: string.IDString
+    /**
+     * 组件或页面实例，限定在什么范围内查找id
+     * @uniPlatform {
+     *  "app": {
+     *    "android": {
+     *        "osVer": "5.0",
+     *        "uniVer": "x",
+     *        "unixVer": "4.25"
+     *      },
+     *      "ios": {
+     *          "osVer": "10.0",
+     *          "uniVer": "x",
+     *          "unixVer": "4.25"
+     *      }
+     *  },
+     *  "web": {
+     *      "uniVer": "x",
+     *      "unixVer": "4.25"
+     *  }
+     * }
+     */
+    component?: ComponentPublicInstance
+    /**
+     * 接口调用成功的回调函数
+     * @uniPlatform {
+     *  "app": {
+     *    "android": {
+     *        "osVer": "5.0",
+     *        "uniVer": "x",
+     *        "unixVer": "4.25"
+     *      },
+     *      "ios": {
+     *          "osVer": "10.0",
+     *          "uniVer": "x",
+     *          "unixVer": "4.25"
+     *      }
+     *  },
+     *  "web": {
+     *      "uniVer": "x",
+     *      "unixVer": "4.25"
+     *  }
+     * }
+     */
+    success?: CreateCanvasContextAsyncSuccessCallback
+    /**
+     * 接口调用失败的回调函数
+     * @uniPlatform {
+     *  "app": {
+     *    "android": {
+     *        "osVer": "5.0",
+     *        "uniVer": "x",
+     *        "unixVer": "4.25"
+     *      },
+     *      "ios": {
+     *          "osVer": "10.0",
+     *          "uniVer": "x",
+     *          "unixVer": "4.25"
+     *      }
+     *  },
+     *  "web": {
+     *      "uniVer": "x",
+     *      "unixVer": "4.25"
+     *  }
+     * }
+     */
+    fail?: CreateCanvasContextAsyncFailCallback
+    /**
+     * 接口调用结束的回调函数（调用成功、失败都会执行）
+     * @uniPlatform {
+     *  "app": {
+     *    "android": {
+     *        "osVer": "5.0",
+     *        "uniVer": "x",
+     *        "unixVer": "4.25"
+     *      },
+     *      "ios": {
+     *          "osVer": "10.0",
+     *          "uniVer": "x",
+     *          "unixVer": "4.25"
+     *      }
+     *  },
+     *  "web": {
+     *      "uniVer": "√",
+     *      "unixVer": "4.25"
+     *  }
+     * }
+     */
+    complete?: CreateCanvasContextAsyncCompleteCallback
+}
+
+export interface Uni {
+  /**
+   * 获取CanvasContext对象实例
+   *
+   * @tutorial-uni-app-x https://doc.dcloud.net.cn/uni-app-x/api/createCanvasContextAsync.html
+   * @uniPlatform {
+   *  "app": {
+   *    "android": {
+   *      "osVer": "5.0",
+   *      "uniVer": "x",
+   *      "unixVer": "4.25"
+   *    },
+   *    "ios": {
+   *      "osVer": "12.0",
+   *      "uniVer": "x",
+   *      "unixVer": "4.25"
+   *    }
+   *  },
+   *  "web": {
+   *    "uniVer": "x",
+   *    "unixVer": "4.25"
+   *  }
+   * }
+   */
+  createCanvasContextAsync(options: CreateCanvasContextAsyncOptions): void
+}