Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
0c9a8811
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
0c9a8811
编写于
3月 18, 2022
作者:
P
panqiangbiao
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add medialib api6
Signed-off-by:
N
panqiangbiao
<
panqiangbiao@huawei.com
>
上级
431813fd
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
300 addition
and
0 deletion
+300
-0
zh-cn/application-dev/reference/apis/js-apis-medialibrary.md
zh-cn/application-dev/reference/apis/js-apis-medialibrary.md
+300
-0
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-medialibrary.md
浏览文件 @
0c9a8811
...
@@ -417,6 +417,275 @@ var media = mediaLibrary.getMediaLibrary(context);
...
@@ -417,6 +417,275 @@ var media = mediaLibrary.getMediaLibrary(context);
media.release()
media.release()
```
```
### storeMediaAsset
storeMediaAsset(option: MediaAssetOption, callback: AsyncCallback
<
string
>
): void
保存媒体资源,以异步方法获取保存成功的URI,使用callback形式返回结果。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Multimedia.MediaLibrary.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------- | ---- | ------------------------------------------- |
| option |
[
MediaAssetOption
](
#mediaassetoption
)
| 是 | 媒体资源选项。 |
| callback | AsyncCallback
<
string
>
| 是 | 媒体资源保存回调,返回保存成功后得到的URI。 |
**示例:**
```
let option = {
src : "file:///data/data/ohos.xxx.yyy/files/image.png",
mimeType : "image/jpeg",
relativePath : "imageDir/image2/"
};
mediaLibrary.getMediaLibrary().storeMediaAsset(option, (err, value) => {
if (err) {
console.log("An error occurred when storing media resources.");
return;
}
console.log("Media resources stored. ");
// Obtain the URI that stores media resources.
});
```
### storeMediaAsset
storeMediaAsset(option: MediaAssetOption): Promise
<
string
>
保存媒体资源,以异步方法获取保存成功的URI,使用Promise形式返回结果。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Multimedia.MediaLibrary.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------------------------- | ---- | -------------- |
| option |
[
MediaAssetOption
](
#mediaassetoption
)
| 是 | 媒体资源选项。 |
**返回值:**
| 类型 | 说明 |
| --------------------- | ---------------------------------------------- |
| Promise
<
string
>
| Promise实例,用于异步获取保存成功后得到的URI。 |
**示例:**
```
let option = {
src : "file:///data/data/ohos.xxx.yyy/files/image.jpg",
mimeType : "image/jpeg",
relativePath : "imageDir/image2/"
};
mediaLibrary.getMediaLibrary().storeMediaAsset(option).then((value) => {
console.log("Media resources stored.");
// Obtain the URI that stores media resources.
}).catch((err) => {
console.log("An error occurred when storing media resources.");
});
```
### startImagePreview
startImagePreview(images: Array
<
string
>
, index: number, callback: AsyncCallback
<
void
>
): void
启动图片预览界面并限定预览开始显示的图片。可以预览指定序号的单张本地图片(dataability://),也可以预览列表中的所有网络图片(https://)。使用callback方式进行异步回调。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Multimedia.MediaLibrary.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | --------------------------------------------------- |
| images | Array
<
string
>
| 是 | 预览的图片URI("https://","dataability://")列表。 |
| index | number | 是 | 开始显示的图片序号。 |
| callback | AsyncCallback
<
void
>
| 是 | 图片预览回调,失败时返回错误信息。 |
**示例:**
```
let images = [
"dataability:///media/external/images/media/50",
"dataability:///media/external/images/media/55"
];
let images = [
"https://media.xxxx.com/image1.jpg",
"https://media.xxxx.com/image2.jpg"
];
let index = 1;
mediaLibrary.getMediaLibrary().startImagePreview(images, index, (err) => {
if (err) {
console.log("An error occurred when previewing the images.");
return;
}
console.log("Succeeded in previewing the images.");
});
```
### startImagePreview
startImagePreview(images: Array
<
string
>
, callback: AsyncCallback
<
void
>
): void
启动图片预览界面,可以预览列表中首张本地图片(dataability://),也可以预览列表中的所有网络图片(https://)。使用callback方式进行异步回调。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Multimedia.MediaLibrary.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | --------------------------------------------------- |
| images | Array
<
string
>
| 是 | 预览的图片URI("https://","dataability://")列表。 |
| callback | AsyncCallback
<
void
>
| 是 | 图片预览回调,失败时返回错误信息。 |
**示例:**
```
let images = [
"dataability:///media/external/images/media/50",
"dataability:///media/external/images/media/55"
];
let images = [
"https://media.xxxx.com/image1.jpg",
"https://media.xxxx.com/image2.jpg"
];
mediaLibrary.getMediaLibrary().startImagePreview(images, (err) => {
if (err) {
console.log("An error occurred when previewing the images.");
return;
}
console.log("Succeeded in previewing the images.");
});
```
### startImagePreview
startImagePreview(images: Array
<
string
>
, index?: number): Promise
<
void
>
启动图片预览界面并限定预览开始显示的图片。可以预览指定序号的单张本地图片(dataability://),也可以预览列表中的所有网络图片(https://)。使用Promise方式进行异步回调。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Multimedia.MediaLibrary.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------- | ---- | --------------------------------------------------- |
| images | Array
<
string
>
| 是 | 预览的图片URI("https://","dataability://")列表。 |
| index | number | 否 | 开始显示的图片序号,不选择时默认为0。 |
**返回值:**
| 类型 | 说明 |
| ------------------- | ------------------------------------------------------- |
| Promise
<
void
>
| Promise实例,用于异步获取预览结果,失败时返回错误信息。 |
**示例:**
```
let images = [
"dataability:///media/external/images/media/50",
"dataability:///media/external/images/media/55"
];
let images = [
"https://media.xxxx.com/image1.jpg",
"https://media.xxxx.com/image2.jpg"
];
let index = 1;
mediaLibrary.getMediaLibrary().startImagePreview(images, index).then(() => {
console.log("Succeeded in previewing the images.");
}).catch((err) => {
console.log("An error occurred when previewing the images.");
});
```
### startMediaSelect
startMediaSelect(option: MediaSelectOption, callback: AsyncCallback
<
Array
<
string
>>
): void
启动媒体选择界面,以异步方法获取选择的媒体URI列表,使用callback形式返回结果。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Multimedia.MediaLibrary.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------------------------------------------- |
| option |
[
MediaSelectOption
](
#mediaselectoption
)
| 是 | 媒体选择选项。 |
| callback | AsyncCallback
<
Array
<
string
>>
| 是 | 媒体选择回调,返回选择的媒体URI(dataability://)列表。 |
**示例:**
```
let option = {
type : "image",
count : 2
};
mediaLibrary.getMediaLibrary().startMediaSelect(option, (err, value) => {
if (err) {
console.log("An error occurred when selecting media resources.");
return;
}
console.log("Media resources selected.");
// Obtain the media selection value.
});
```
### startMediaSelect
startMediaSelect(option: MediaSelectOption): Promise
<
Array
<
string
>>
启动媒体选择界面,以异步方法获取选择的媒体URI列表,使用Promise形式返回结果。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力**
:SystemCapability.Multimedia.MediaLibrary.Core
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | --------------------------------------- | ---- | -------------- |
| option |
[
MediaSelectOption
](
#mediaselectoption
)
| 是 | 媒体选择选项。 |
**返回值:**
| 类型 | 说明 |
| ---------------------------------- | ------------------------------------------------------------ |
| Promise
<
Array
<
string
>>
| Promise实例,用于异步获取选择的媒体URI(dataability://)列表。 |
**示例:**
```
let option = {
type : "image",
count : 2
};
mediaLibrary.getMediaLibrary().startMediaSelect(option).then((value) => {
console.log("Media resources selected.");
// Obtain the media selection value.
}).catch((err) => {
console.log("An error occurred when selecting media resources.");
});
```
## FileAsset<sup>8+</sup>
## FileAsset<sup>8+</sup>
提供封装文件属性的方法。
提供封装文件属性的方法。
...
@@ -1907,3 +2176,34 @@ DeviceType
...
@@ -1907,3 +2176,34 @@ DeviceType
| width | number | 是 | 是 | 宽(单位:像素) |
| width | number | 是 | 是 | 宽(单位:像素) |
| height | number | 是 | 是 | 高(单位:像素) |
| height | number | 是 | 是 | 高(单位:像素) |
## MediaAssetOption
媒体资源选项。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core
| 名称 | 类型 | 必填 | 描述 |
| ------------ | ------ | ---- | ------------------------------------------------------------ |
| src | string | 是 | 媒体库数据的URI。 |
| mimeType | string | 是 | 媒体MIME(Multipurpose
Internet
Mail
Extensions)类型。
<br/>
例:'image/
\*
'、'video/
\*
'等。 |
| relativePath | string | 否 | 自定义媒体资源保存位置,不填则保存到默认路径。例:imageDir/image2/(媒体资源将保存位置为:default/imageDir/image2/),default为默认保存路径。 |
## MediaSelectOption
媒体资源类型选项。
本接口在OpenHarmony 3.1 Release版本仅为接口定义,暂不支持使用。接口将在OpenHarmony 3.1 MR版本中提供使用支持。
**系统能力:**
以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core
### 属性
| 名称 | 类型 | 必填 | 描述 |
| ----- | ------ | ---- | ------------------------------ |
| type | string | 是 | 媒体类型,包括:image,video。 |
| count | number | 是 | 媒体选择最大数量。 |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录