媒体

图片

Taro.chooseImage(OBJECT)

使用方式同 wx.chooseImage,支持 Promise 化使用。

注:RN端该API不支持 count 属性;不支持相机与相册同时选择,只会取 sourceType 数组里的第一个值。默认从相册选取图片。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.chooseImage(params).then(...)

Taro.previewImage(OBJECT)

使用方式同 wx.previewImage,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.previewImage(params).then(...)

Taro.getImageInfo(OBJECT)

使用方式同 wx.getImageInfo,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.getImageInfo(params).then(...)

Taro.saveImageToPhotosAlbum(OBJECT)

使用方式同 wx.saveImageToPhotosAlbum,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.saveImageToPhotosAlbum(params).then(...)

API 支持度

API 微信小程序 H5 ReactNative 支付宝小程序 百度小程序
Taro.chooseImage ✔️ ✔️ ✔️ ✔️ ✔️
Taro.previewImage ✔️ ✔️ ✔️ ✔️
Taro.getImageInfo ✔️ ✔️ ✔️ ✔️
Taro.saveImageToPhotosAlbum ✔️ ✔️ ✔️ ✔️

录音

Taro.startRecord(OBJECT)

使用方式同 wx.startRecord,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.startRecord(params).then(...)

Taro.stopRecord()

​主动调用停止录音。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.stopRecord()

API 支持度

API 微信小程序 H5 ReactNative 支付宝小程序 百度小程序
Taro.startRecord ✔️
Taro.stopRecord ✔️

录音管理

Taro.getRecorderManager()

使用方式同 wx.getRecorderManager

示例代码:

  1. import Taro from '@tarojs/taro'
  2. const recorderManager = Taro.getRecorderManager()

API 支持度

API 微信小程序 H5 ReactNative 支付宝小程序 百度小程序
Taro.getRecorderManager ✔️

音频播放控制

Taro.playVoice(OBJECT)

使用方式同 wx.playVoice,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.playVoice(params).then(...)

Taro.pauseVoice()

暂停正在播放的语音。再次调用 Taro.playVoice 播放同一个文件时,会从暂停处开始播放。如果想从头开始播放,需要先调用 Taro.stopVoice。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.startRecord(params)
  3. .then(res => {
  4. const filePath = res.tempFilePath
  5. Taro.playVoice({ filePath })
  6. setTimeout(Taro.pauseVoice, 5000)
  7. })

Taro.stopVoice

结束播放语音。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.startRecord(params)
  3. .then(res => {
  4. const filePath = res.tempFilePath
  5. Taro.playVoice({ filePath })
  6. setTimeout(Taro.stopVoice, 5000)
  7. })

API 支持度

API 微信小程序 H5 ReactNative 支付宝小程序 百度小程序
Taro.playVoice ✔️
Taro.pauseVoice ✔️
Taro.stopVoice ✔️

音乐播放控制

Taro.getBackgroundAudioPlayerState(OBJECT)

使用方式同 wx.getBackgroundAudioPlayerState,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.getBackgroundAudioPlayerState(params).then(...)

Taro.playBackgroundAudio(OBJECT)

使用方式同 wx.playBackgroundAudio,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.playBackgroundAudio(params).then(...)

Taro.pauseBackgroundAudio()

暂停播放音乐。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.pauseBackgroundAudio()

Taro.seekBackgroundAudio(OBJECT)

使用方式同 wx.seekBackgroundAudio,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.seekBackgroundAudio(params).then(...)

Taro.stopBackgroundAudio()

停止播放音乐。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.stopBackgroundAudio()

Taro.onBackgroundAudioPlay(CALLBACK)

监听音乐播放。

Taro.onBackgroundAudioPause(CALLBACK)

监听音乐暂停。

Taro.onBackgroundAudioStop(CALLBACK)

监听音乐停止。

API 支持度

API 微信小程序 H5 ReactNative 支付宝小程序 百度小程序
Taro.getBackgroundAudioPlayerState ✔️
Taro.playBackgroundAudio ✔️
Taro.pauseBackgroundAudio ✔️
Taro.seekBackgroundAudio ✔️
Taro.stopBackgroundAudio ✔️
Taro.onBackgroundAudioPlay ✔️
Taro.onBackgroundAudioPause ✔️
Taro.onBackgroundAudioStop ✔️

背景音频播放管理

Taro.getBackgroundAudioManager()

使用方式同 wx.getBackgroundAudioManager

示例代码:

  1. import Taro from '@tarojs/taro'
  2. const backgroundAudioManager = Taro.getBackgroundAudioManager()

API 支持度

API 微信小程序 H5 ReactNative
Taro.getBackgroundAudioManager ✔️

音频组件控制

Taro.createAudioContext(audioId, this.$scope)

使用方式同 wx.createAudioContext

示例代码:

  1. import Taro from '@tarojs/taro'
  2. const audioCtx = Taro.createAudioContext('myAudio')

Taro.createInnerAudioContext()

使用方式同 wx.createInnerAudioContext

示例代码:

  1. import Taro from '@tarojs/taro'
  2. const innerAudioContext = Taro.createInnerAudioContext()

API 支持度

API 微信小程序 H5 ReactNative 支付宝小程序 百度小程序
Taro.createAudioContext ✔️
Taro.createInnerAudioContext ✔️

视频

Taro.chooseVideo(OBJECT)

使用方式同 wx.chooseVideo,支持 Promise 化使用。

注:RN端该API不支持 compressedmaxDurationcamera 属性;不支持相册与相机同时选择,只会取 sourceType 数组里的第一个值。默认从相册选取视频。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.chooseVideo(params).then(...)

Taro.saveVideoToPhotosAlbum(OBJECT)

使用方式同 wx.saveVideoToPhotosAlbum,支持 Promise 化使用。

示例代码:

  1. import Taro from '@tarojs/taro'
  2. Taro.saveVideoToPhotosAlbum(params).then(...)

API 支持度

API 微信小程序 H5 ReactNative
Taro.chooseVideo ✔️ ✔️
Taro.saveVideoToPhotosAlbum ✔️ ✔️

视频组件控制

Taro.createVideoContext(videoId, this.$scope)

使用方式同 wx.createVideoContext

示例代码:

  1. import Taro from '@tarojs/taro'
  2. const videoContext = Taro.createVideoContext('myVideo')

API 支持度

API 微信小程序 H5 ReactNative
Taro.createVideoContext ✔️

相机组件控制

Taro.createCameraContext(this.$scope)

使用方式同 wx.createCameraContext

示例代码:

  1. import Taro from '@tarojs/taro'
  2. const cameraContext = Taro.createCameraContext()

API 支持度

API 微信小程序 H5 ReactNative
Taro.createCameraContext ✔️