快應用 多媒體

接口聲明

{"name": "system.media"}

導入模塊

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

接口定義

media.takePhoto(OBJECT)

拍攝照片

權限要求

使用相機

參數(shù)：

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)

拍攝視頻

權限要求

使用相機

參數(shù)：

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)

選擇圖片

權限要求

讀手機存儲

參數(shù)：

success返回值：

file對象如下：

示例：

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

media.pickVideo(OBJECT)

選擇視頻

權限要求

讀手機存儲

參數(shù)：

success返回值：

示例：

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

media.pickVideos(OBJECT) 

選擇多個視頻

權限要求

讀手機存儲

參數(shù)：

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)

選擇文件

權限要求

讀手機存儲

參數(shù)：

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)

將圖片/視頻保存到相冊中

權限要求

寫手機存儲

參數(shù)：

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)

預覽圖片，調用之后會在新打開的頁面中全屏預覽傳入的圖片，預覽的過程中用戶可以左右滑動瀏覽，可以通過雙指縮放圖片，可以保存圖片到相冊。

權限要求

寫手機存儲

參數(shù)：

示例：

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) 

獲取系統(tǒng)鈴聲。如果是獲取來電鈴聲，雙卡情況下，獲取的是卡 1 對應的鈴聲。

權限要求

讀手機存儲

參數(shù)：

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)

設置系統(tǒng)鈴聲，目前只支持本地文件。如果是設置來電鈴聲，雙卡情況下，卡 1 卡 2 對應的鈴聲都會設置。

權限要求

寫手機存儲。而且每次設置鈴聲時，都有彈框來讓用戶選擇是否同意設置鈴聲。

參數(shù)：

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

后臺運行限制

禁止使用。后臺運行詳細用法參見 后臺運行腳本。