多媒体 media

接口声明

{ "name": "system.media" }

导入模块

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

接口定义

media.takePhoto(OBJECT)

拍摄照片

权限要求

使用相机

参数：

success 返回值：

fail 返回错误代码

示例：

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

media.takeVideo(OBJECT)

拍摄视频

权限要求

使用相机

参数：

success 返回值：

fail 返回错误代码

示例：

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

media.pickImage(OBJECT)

选择图片

权限要求

读手机存储

参数：

success 返回值：

示例：

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

media.pickImages(OBJECT) 1040+

选择多张图片

权限要求

读手机存储

参数：

success 返回值：

file对象如下：

示例：

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

media.pickVideo(OBJECT)

选择视频

权限要求

读手机存储

参数：

success 返回值：

示例：

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

media.pickVideos(OBJECT) 1040+

选择多个视频

权限要求

读手机存储

参数：

success 返回值：

file对象如下：

示例：

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

media.pickFile(OBJECT)1010+

选择文件

权限要求

读手机存储

参数：

success 返回值：

示例：

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+

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

权限要求

写手机存储

参数：

fail 返回错误代码：

示例：

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

media.previewImage(OBJECT)1040+

预览图片，调用之后会在新打开的页面中全屏预览传入的图片，预览的过程中用户可以左右滑动浏览，可以通过双指缩放图片，可以保存图片到相册。

权限要求

写手机存储

参数：

示例：

media.previewImage({
  current: 'http://www.xxx.com/a.jpg',
  uris: [
    'http://www.xxx.com/a.jpg',
    'http://www.xxx.com/b.jpg',
    'http://www.xxx.com/c.jpg'
  ],
  success: function() {
    console.log('preview success')
  },
  fail: function(data, code) {
    console.log('preview fail, code = ${code}')
  }
})

media.getRingtone(OBJECT) 1040+

获取系统铃声。如果是获取来电铃声，双卡情况下，获取的是卡 1 对应的铃声。

权限要求

读手机存储

参数：

success 返回值：

fail 返回错误代码：

示例：

media.getRingtone({
  type: 'ringtone',
  success: function(data) {
    console.log(`get ringtone success title: ${data.title}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

media.setRingtone(OBJECT) 1040+

设置系统铃声，目前只支持本地文件。如果是设置来电铃声，双卡情况下，卡 1 卡 2 对应的铃声都会设置。

权限要求

写手机存储。而且每次设置铃声时，都有弹框来让用户选择是否同意设置铃声。

参数：

fail 返回错误代码：

示例：

media.setRingtone({
  type: 'ringtone',
  uri: 'internal://mass/test/test.mp3',
  title: 'test',
  success: function() {
    console.log(`set ringtone success`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

后台运行限制

禁止使用。
后台运行详细用法参见后台运行 脚本。