codecamp

快应用 多媒体

参数名类型说明
uriString选取的文件路径
name 1060+String选取的文件名称
size 1060+Number选取的文件大小，单位B

接口声明

{"name": "system.media"}

导入模块

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

接口定义

media.takePhoto(OBJECT)

拍摄照片

权限要求

使用相机

参数：

参数名 类型 必填 说明
success Function 否 成功回调
fail Function 否 失败回调
cancel Function 否 取消回调
complete Function 否 执行结束后的回调
success返回值：
参数名类型说明
uriString选取的文件路径
name 1060+String选取的文件名称
size 1060+Number选取的文件大小，单位B
fail返回错误代码
错误码 说明
201 用户拒绝，获取相机权限失败

示例：

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 Function 否 成功回调，参数为 {uri: 'file:///video.avi'}
fail Function 否 失败回调
cancel Function 否 取消回调
complete Function 否 执行结束后的回调
success返回值：
参数名类型说明
uriString选取的文件路径
name 1060+String选取的文件名称
size 1060+Number选取的文件大小，单位B
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)

选择图片

权限要求

读手机存储

参数：

参数名 类型 必填 说明
success Function 否 成功回调
fail Function 否 失败回调
cancel Function 否 取消回调
complete Function 否 执行结束后的回调
success返回值：
参数名类型说明
uriString选取的文件路径
name 1060+String选取的文件名称
size 1060+Number选取的文件大小，单位B
file对象如下：
参数名类型说明
uriString选取的文件路径
nameString选取的文件名称
sizeNumber选取的文件大小，单位B

示例：

media.pickImage({

  success: function(data) {

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

  },

  fail: function(data, code) {

    console.log(`handling fail, code = ${code}`)

  }

})

media.pickVideo(OBJECT)

选择视频

权限要求

读手机存储

参数：

参数名 类型 必填 说明
success Function 否 成功回调
fail Function 否 失败回调
cancel Function 否 取消回调
complete Function 否 执行结束后的回调
success返回值：
参数名类型说明
uriString选取的文件路径
name 1060+String选取的文件名称
size 1060+Number选取的文件大小，单位B

示例：

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

media.pickVideos(OBJECT) 

选择多个视频

权限要求

读手机存储

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
cancelFunction否取消回调
completeFunction否执行结束后的回调
success 返回值：
参数名类型说明
urisArray选取的文件路径列表
files 1060+Array选取的文件列表，是一个file对象的数组

file对象如下：

参数名类型说明
uriString选取的文件路径
nameString选取的文件名称
sizeNumber选取的文件大小，单位B

示例：

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

media.pickFile(OBJECT)

选择文件

权限要求

读手机存储

参数：

参数名 类型 必填 说明
success Function 否 成功回调
fail Function 否 失败回调
cancel Function 否 取消回调
complete Function 否 执行结束后的回调
success返回值：
参数名类型说明
uriString选取的文件路径
name 1060+String选取的文件名称
size 1060+Number选取的文件大小，单位B

示例：

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

media.saveToPhotosAlbum(OBJECT)

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

权限要求

写手机存储

参数：

参数名 类型 必填 说明
uri String 是 源文件的uri，文件的扩展名必须是图片或视频的扩展名
success Function 否 成功回调
fail Function 否 失败回调
complete Function 否 执行结束后的回调
fail返回错误代码：
错误码 说明
201 用户拒绝
202 参数错误
300 I/O错误

示例：

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)

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

权限要求

写手机存储

参数：

参数名类型必填说明
currentNumber 或 String否数据类型可选择 Number 或者 String：
Number：当前显示的图片的下标，默认 0；
String：当前显示的图片链接，默认为 uris 中的第一张的地址
urisArray是需要预览的图片链接列表，同时支持网络和本地地址
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

示例：

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) 

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

权限要求

读手机存储

参数：

参数名类型必填说明
typeString是铃声类型，ringtone：来电，notification：通知，alarm：闹钟
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数名类型说明
titleString铃声名称，若铃声被删除，返回空字符串。
fail 返回错误代码：
错误码说明
202参数错误，即铃声类型不对

示例：

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)

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

权限要求

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

参数：

参数名类型必填说明
uriString是铃声文件路径，只支持本地文件
typeString是铃声类型，ringtone：来电，notification：通知，alarm：闹钟
titleString否铃声名称，没有设置默认取文件名
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
fail 返回错误代码：
错误码说明
201用户拒绝
202参数错误，即铃声类型不对，目前支持的铃声类型有 15 种，文件后缀分别为：.mp3、 .ogg、 .oga、 .flac、 .wav、 .m4a、 .amr、 .awb、 .wma、 .aac、 .mka、 .mid、 .midi、 .smf、 .imy 。
1001文件不存在

示例：

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}`)
  }
})

后台运行限制

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


快应用 密码算法
快应用 图片编辑
温馨提示
下载编程狮App，免费阅读超1000+编程语言教程
取消
确定
目录

快应用 指南

快应用 教程

快应用 总述

快应用 入门教程

快应用 框架教程

快应用 组件教程

快应用 平台教程

快应用 接口

快应用 其他

快应用 工具

快应用 参考手册

快应用 框架概述

快应用 组件文档

快应用 通用组件

快应用 容器组件

快应用 基础组件

快应用 表单组件

快应用 媒体组件

快应用 其他组件

快应用 画布组件

快应用 第三方组件

快应用 接口文档

快应用 界面交互

快应用 网络访问

快应用 文件数据

快应用 系统能力

快应用 安全

快应用 图形图像

快应用 声音音频

快应用 厂商服务

快应用 第三方服务

快应用 厂商开发者平台

OPPO开放平台 快应用文档

快应用 开发工具

快应用 厂商开发者账号申请

快应用 资源下载

关闭

 MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }