教程 其他 框架 组件 接口

多媒体

接口声明

{ "name": "system.media" }

导入模块

import media from '@system.media'const media = require('@system.media')

接口定义

media.takePhoto(OBJECT)

拍摄照片

权限要求

使用相机

参数:

参数名类型必填说明
successFunction成功回调
failFunction失败回调
cancelFunction取消回调
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
uriString选取的文件路径
fail 返回错误代码
错误码说明
201用户拒绝,获取相机权限失败

示例:

media.takePhoto({
  success: function(data) {
    console.log(`handling success: ${data.uri}`)
  }
})

media.takeVideo(OBJECT)

拍摄视频

权限要求

使用相机

参数:

参数名类型必填说明
successFunction成功回调,参数为 {uri: 'file:///video.avi'}
failFunction失败回调
cancelFunction取消回调
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
uriString选取的文件路径
fail 返回错误代码
错误码说明
201用户拒绝,获取相机权限失败

示例:

media.takeVideo({
  success: function(data) {
    console.log(`handling success: ${data.uri}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

media.pickImage(OBJECT)

选择图片

权限要求

读手机存储

参数:

参数名类型必填说明
successFunction成功回调
failFunction失败回调
cancelFunction取消回调
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
uriString选取的文件路径

示例:

media.pickImage({
  success: function(data) {
    console.log(`handling success: ${data.uri}`)
  }
})

media.pickVideo(OBJECT)

选择视频

权限要求

读手机存储

参数:

参数名类型必填说明
successFunction成功回调
failFunction失败回调
cancelFunction取消回调
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
uriString选取的文件路径

示例:

media.pickVideo({
  success: function(data) {
    console.log(`handling success: ${data.uri}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

media.pickFile(OBJECT)1010+

选择文件

权限要求

读手机存储

参数:

参数名类型必填说明
successFunction成功回调
failFunction失败回调
cancelFunction取消回调
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
uriString选取的文件路径

示例:

media.pickFile({
  success: function(data) {
    console.log(`handling success: ${data.uri}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

media.saveToPhotosAlbum(OBJECT)1010+

将图片/视频保存到相册中

权限要求

写手机存储

参数:

参数名类型必填说明
uriString源文件的 uri,文件的扩展名必须是图片或视频的扩展名
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
fail 返回错误代码:
错误码说明
201用户拒绝
202参数错误
300I/O 错误

示例:

media.saveToPhotosAlbum({
  uri: 'internal://tmp/abc.jpg',
  success: function() {
    console.log(`save success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容