@tarojs/taro 3.5.0-canary.0 → 3.5.0-canary.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "3.5.0-canary.0",
+  "version": "3.5.0-canary.1",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -26,9 +26,9 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "3.5.0-canary.0",
-    "@tarojs/runtime": "3.5.0-canary.0",
-    "@tarojs/taro-h5": "3.5.0-canary.0"
+    "@tarojs/api": "3.5.0-canary.1",
+    "@tarojs/runtime": "3.5.0-canary.1",
+    "@tarojs/taro-h5": "3.5.0-canary.1"
   },
-  "gitHead": "a0222bc41bc05b0e34413d6db3de963d777a5015"
+  "gitHead": "c61624d2f763e6d31e67d6cf9c564efc8b0d0887"
 }

package/types/api/base/weapp/app-event.d.ts

@@ -69,7 +69,7 @@ declare module '../../../index' {
      * - 开发者可以在回调中进行页面重定向，但必须在回调中**同步**处理，异步处理（例如 `setTimeout` 异步执行）无效。
      * - 若开发者没有调用 [Taro.onPageNotFound](https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onPageNotFound.html) 绑定监听，也没有声明 `App.onPageNotFound`，当跳转页面不存在时，将推入微信客户端原生的页面不存在提示页面。
      * - 如果回调中又重定向到另一个不存在的页面，将推入微信客户端原生的页面不存在提示页面，并且不再第二次回调。
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/base/app/app-event/wx.onPageNotFound.html
      */
     onPageNotFound(callback: onPageNotFound.Callback): void
@@ -130,7 +130,7 @@ declare module '../../../index' {
      */
     onAppHide(
       /** 小程序切后台事件的回调函数 */
-      callback: (res: TaroGeneral.CallbackResult) => void,
+      callback: (res: onAppShow.CallbackResult) => void,
     ): void
 
     /** 取消监听小程序要打开的页面不存在事件
@@ -139,7 +139,7 @@ declare module '../../../index' {
      */
     offPageNotFound(
       /** 小程序要打开的页面不存在事件的回调函数 */
-      callback: (res: TaroGeneral.CallbackResult) => void,
+      callback: (res: onPageNotFound.Callback) => void,
     ): void
 
     /** 取消监听音频播放错误事件
@@ -149,7 +149,7 @@ declare module '../../../index' {
 
     offError(
       /** 音频播放错误事件的回调函数 */
-      callback: (res: TaroGeneral.CallbackResult) => void,
+      callback: (res: onError.Callback) => void,
     ): void
 
     /** 取消监听音频中断结束事件

package/types/api/canvas/index.d.ts

@@ -1374,7 +1374,7 @@ declare module '../../index' {
     /** 阴影的模糊级别 */
     shadowBlur: number
     /** 阴影的颜色 */
-    shadowColor: number
+    shadowColor: string
     /** 阴影相对于形状在水平方向的偏移 */
     shadowOffsetX: number
     /** 阴影相对于形状在竖直方向的偏移 */
@@ -1698,6 +1698,27 @@ declare module '../../index' {
      *
      * **Tip**: 需要指定 canvasId，该绘图上下文只作用于对应的 `<canvas/>`
      * @supported weapp, h5
+     * @example
+     * ```tsx
+     * const context = Taro.createCanvasContext('canvas')
+     *
+     * context.setStrokeStyle("#00ff00")
+     * context.setLineWidth(5)
+     * context.rect(0, 0, 200, 200)
+     * context.stroke()
+     * context.setStrokeStyle("#ff0000")
+     * context.setLineWidth(2)
+     * context.moveTo(160, 100)
+     * context.arc(100, 100, 60, 0, 2 * Math.PI, true)
+     * context.moveTo(140, 100)
+     * context.arc(100, 100, 40, 0, Math.PI, false)
+     * context.moveTo(85, 80)
+     * context.arc(80, 80, 5, 0, 2 * Math.PI, true)
+     * context.moveTo(125, 80)
+     * context.arc(120, 80, 5, 0, 2 * Math.PI, true)
+     * context.stroke()
+     * context.draw()
+     * ```
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/canvas/wx.createCanvasContext.html
      */
     createCanvasContext(

package/types/api/device/compass.d.ts

@@ -94,7 +94,7 @@ declare module '../../index' {
     ): void
 
     /** 取消监听罗盘数据变化事件，参数为空，则取消所有的事件监听。
-     * @supported weapp
+     * @supported weapp, h5
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/device/compass/wx.offCompassChange.html
      */
     offCompassChange(

package/types/api/media/audio.d.ts

@@ -153,22 +153,16 @@ declare module '../../index' {
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/audio/InnerAudioContext.html
    */
   interface InnerAudioContext {
+    /** 音频资源的地址，用于直接播放。 */
+    src: string
+    /** 开始播放的位置（单位：s）
+     * @default 0
+     */
+    startTime: number
     /** 是否自动开始播放
      * @default false
      */
     autoplay: boolean
-    /** 音频缓冲的时间点，仅保证当前播放时间点到此时间点内容已缓冲
-     * @readonly
-     */
-    buffered: number
-    /** 当前音频的播放位置（单位 s）。只有在当前有合法的 src 时返回，时间保留小数点后 6 位
-     * @readonly
-     */
-    currentTime: number
-    /** 当前音频的长度（单位 s）。只有在当前有合法的 src 时返回
-     * @readonly
-     */
-    duration: number
     /** 是否循环播放
      * @default false
      */
@@ -177,16 +171,6 @@ declare module '../../index' {
      * @default true
      */
     obeyMuteSwitch: boolean
-    /** 当前是是否暂停或停止状态
-     * @readonly
-     */
-    paused: boolean
-    /** 音频资源的地址，用于直接播放。 */
-    src: string
-    /** 开始播放的位置（单位：s）
-     * @default 0
-     */
-    startTime: number
     /** 音量。范围 0~1。
      * @default 1
      */
@@ -195,6 +179,24 @@ declare module '../../index' {
      * @default 1
      */
     playbackRate: number
+    /** 当前音频的长度（单位 s）。只有在当前有合法的 src 时返回
+     * @readonly
+     */
+    duration: number
+    /** 当前音频的播放位置（单位 s）。只有在当前有合法的 src 时返回，时间保留小数点后 6 位
+     * @readonly
+     */
+    currentTime: number
+    /** 当前是是否暂停或停止状态
+     * @readonly
+     */
+    paused: boolean
+    /** 音频缓冲的时间点，仅保证当前播放时间点到此时间点内容已缓冲
+     * @readonly
+     */
+    buffered: number
+    /** origin: 发送完整的 referrer; no-referrer: 不发送 */
+    referrerPolicy?: 'origin' | 'no-referrer' | string
     /** 播放 */
     play(): void
     /** 暂停 */

package/types/api/media/background-audio.d.ts

@@ -100,70 +100,76 @@ declare module '../../index' {
    * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/background-audio/BackgroundAudioManager.html
    */
   interface BackgroundAudioManager {
-    /** 音频已缓冲的时间，仅保证当前播放时间点到此时间点内容已缓冲。
-     * @readonly
-     */
-    buffered: number
+    /** 音频的数据源（[2.2.3](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) 开始支持云文件ID）。默认为空字符串，**当设置了新的 src 时，会自动开始播放**，目前支持的格式有 m4a, aac, mp3, wav。 */
+    src: string
+    /** 音频开始播放的位置（单位：s）。 */
+    startTime: number
+    /** 音频标题，用于原生音频播放器音频标题（必填）。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值。 */
+    title: string
+    /** 专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    epname: string
+    /** 歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    singer: string
     /** 封面图 URL，用于做原生音频播放器背景图。原生音频播放器中的分享功能，分享出去的卡片配图及背景也将使用该图。 */
     coverImgUrl: string
-    /** 当前音频的播放位置（单位：s），只有在有合法 src 时返回。
-     * @readonly
+    /** 页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
+    webUrl: string
+    /** 音频协议。默认值为 'http'，设置 'hls' 可以支持播放 HLS 协议的直播音频。 */
+    protocol: string
+    /** 播放速度。范围 0.5-2.0。
+     * @default 1
      */
-    currentTime: number
+    playbackRate?: number
     /** 当前音频的长度（单位：s），只有在有合法 src 时返回。
      * @readonly
      */
     duration: number
-    /** 专辑名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    epname: string
+    /** 当前音频的播放位置（单位：s），只有在有合法 src 时返回。
+     * @readonly
+     */
+    currentTime: number
     /** 当前是否暂停或停止。
      * @readonly
      */
     paused: boolean
-    /** 音频协议。默认值为 'http'，设置 'hls' 可以支持播放 HLS 协议的直播音频。 */
-    protocol: string
-    /** 歌手名，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    singer: string
-    /** 音频的数据源（[2.2.3](https://developers.weixin.qq.com/miniprogram/dev/framework/compatibility.html) 开始支持云文件ID）。默认为空字符串，**当设置了新的 src 时，会自动开始播放**，目前支持的格式有 m4a, aac, mp3, wav。 */
-    src: string
-    /** 音频开始播放的位置（单位：s）。 */
-    startTime: number
-    /** 音频标题，用于原生音频播放器音频标题（必填）。原生音频播放器中的分享功能，分享出去的卡片标题，也将使用该值。 */
-    title: string
-    /** 页面链接，原生音频播放器中的分享功能，分享出去的卡片简介，也将使用该值。 */
-    webUrl: string
+    /** 音频已缓冲的时间，仅保证当前播放时间点到此时间点内容已缓冲。
+     * @readonly
+     */
+    buffered: number
+    /** origin: 发送完整的 referrer; no-referrer: 不发送 */
+    referrerPolicy?: 'origin' | 'no-referrer' | string
     /** 播放 */
     play(): void
     /** 暂停 */
     pause(): void
-    /** 停止 */
-    stop(): void
     /** 跳转到指定位置，单位 s */
     seek(position: any): void
+    /** 停止 */
+    stop(): void
     /** 背景音频进入可以播放状态，但不保证后面可以流畅播放 */
     onCanplay(callback?: () => void): void
+    /** 音频加载中事件，当音频因为数据不足，需要停下来加载时会触发 */
+    onWaiting(callback?: () => void): void
+    /** 背景音频播放错误事件 */
+    onError(callback?: () => void): void
     /** 背景音频播放事件 */
     onPlay(callback?: () => void): void
     /** 背景音频暂停事件 */
     onPause(callback?: () => void): void
-    /** 背景音频停止事件 */
-    onStop(callback?: () => void): void
+    /** 背景音频开始跳转操作事件 */
+    onSeeking(callback?: () => void): void
+    /** 背景音频完成跳转操作事件 */
+    onSeeked(callback?: () => void): void
     /** 背景音频自然播放结束事件 */
     onEnded(callback?: () => void): void
+    /** 背景音频停止事件 */
+    onStop(callback?: () => void): void
     /** 背景音频播放进度更新事件 */
     onTimeUpdate(callback?: () => void): void
     /** 用户在系统音乐播放面板点击上一曲事件（iOS only） */
     onPrev(callback?: () => void): void
     /** 用户在系统音乐播放面板点击下一曲事件（iOS only） */
     onNext(callback?: () => void): void
-    /** 背景音频播放错误事件 */
-    onError(callback?: () => void): void
-    /** 音频加载中事件，当音频因为数据不足，需要停下来加载时会触发 */
-    onWaiting(callback?: () => void): void
-    /** 背景音频开始跳转操作事件 */
-    onSeeking(callback?: () => void): void
-    /** 背景音频完成跳转操作事件 */
-    onSeeked(callback?: () => void): void
   }
 
   interface TaroStatic {

package/types/api/media/image.d.ts

@@ -122,6 +122,8 @@ declare module '../../index' {
       sourceType?: Array<keyof sourceType>
       /** 接口调用成功的回调函数 */
       success?: (result: SuccessCallbackResult) => void
+      /** 用来上传的input元素ID（仅h5端）@supported h5 */
+      imageId?: string
     }
     /** 图片的尺寸 */
     interface sizeType {
@@ -241,66 +243,6 @@ declare module '../../index' {
     }
   }
 
-  namespace chooseMedia {
-    interface Option {
-      /** 最多可以选择的文件个数 */
-      count?: number
-      /** 文件类型 */
-      mediaType?: Array<keyof mediaType>
-      /** 图片和视频选择的来源 */
-      sourceType?: Array<keyof sourceType>
-      /** 拍摄视频最长拍摄时间，单位秒。时间范围为 3s 至 30s 之间 */
-      maxDuration?: number
-      /** 仅对 mediaType 为 image 时有效，是否压缩所选文件 */
-      sizeType?: Array<'original' | 'compressed'>
-      /** 仅在 sourceType 为 camera 时生效，使用前置或后置摄像头 */
-      camera?: string
-      /** 接口调用失败的回调函数 */
-      fail?: (res: TaroGeneral.CallbackResult) => void
-      /** 接口调用成功的回调函数 */
-      success?: (result: SuccessCallbackResult) => void
-    }
-    interface SuccessCallbackResult extends TaroGeneral.CallbackResult {
-      /** 本地临时文件列表 */
-      tempFiles: ChooseMedia[]
-      /** 文件类型，有效值有 image 、video */
-      type: string
-    }
-    /** 本地临时文件列表 */
-    interface ChooseMedia {
-      /** 本地临时文件路径 (本地路径) */
-      tempFilePath: string
-      /** 本地临时文件大小，单位 B */
-      size: number
-      /** 视频的时间长度 */
-      duration: number
-      /** 视频的高度 */
-      height: number
-      /** 视频的宽度 */
-      width: number
-      /** 视频缩略图临时文件路径 */
-      thumbTempFilePath: string
-    }
-    interface mediaType {
-      /** 只能拍摄视频或从相册选择视频 */
-      video
-      /** 只能拍摄图片或从相册选择图片 */
-      image
-    }
-    interface sourceType {
-      /** 从相册选择 */
-      album
-      /** 使用相机拍摄 */
-      camera
-    }
-    interface camera {
-      /** 使用后置摄像头 */
-      back
-      /** 使用前置摄像头 */
-      front
-    }
-  }
-
   interface TaroStatic {
     /** 保存图片到系统相册。需要[用户授权](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html) scope.writePhotosAlbum
      * @supported weapp, rn, alipay, swan
@@ -328,7 +270,7 @@ declare module '../../index' {
     previewImage(option: previewImage.Option): Promise<TaroGeneral.CallbackResult>
 
     /** 预览图片和视频。
-     * @supported weapp 基础库 2.12.0 开始支持，低版本需做兼容处理。
+     * @supported weapp
      * @example
      * ```tsx
      * Taro.previewMedia({
@@ -414,25 +356,5 @@ declare module '../../index' {
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.chooseMessageFile.html
      */
     chooseMessageFile(option: chooseMessageFile.Option): Promise<chooseMessageFile.SuccessCallbackResult>
-
-    /** 拍摄或从手机相册中选择图片或视频。
-     * @supported weapp, rn
-     * @example
-     * ```tsx
-     * Taro.chooseMedia({
-     *   count: 9,
-     *   mediaType: ['image','video'],
-     *   sourceType: ['album', 'camera'],
-     *   maxDuration: 30,
-     *   camera: 'back',
-     *   success: (res) => {
-     *     console.log(res.tempFiles)
-     *     console.log(res.type)
-     *   }
-     * })
-     * ```
-     * @see https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseMedia.html
-     */
-    chooseMedia(option: chooseMedia.Option): Promise<chooseMedia.SuccessCallbackResult>
   }
 }