更新记录

1.0.1（2023-07-10）

• 修复 Vue3 下上传时报错问题

1.0.0（2023-05-29）

• 支持对云存储图片、视频媒体资源管理

平台兼容性

uni-admin插件通用教程：

uni-admin是一套基于uniCloud的开源应用管理端系统。详见：uni-admin 基础框架
本插件是uni-admin系统的扩展插件，为开发者的admin系统添加功能。
需先确保本机有uni-admin项目，然后将此插件导入到uni-admin项目下。
如本机没有uni-admin项目，需要先在HBuilderX中新建项目 -> uni-app项目 -> 选择uni-admin模板。
如本机的uni-admin项目版本过老，可能无法使用新插件，需及时升级本机的uni-admin项目。详见uni-admin项目更新日志

媒体库

管理上传的云存储图片、视频等媒体资源，支持对资源上传、删除、查看等操作。

功能点

• 支持阿里云与腾讯云云存储。
• 对媒体资源管理，支持上传、删除、查看等操作。
• 可作为图片选择器使用，支持插入图片到编辑器中。

如何使用

从插件市场中导入媒体库插件至uni-admin中。

如果还未使用过uni-admin，请先在HBuilderX新建项目时选择uni-admin项目。并需要了解uni-admin的相关知识。

导入uni-media-library后，运行启动uni-admin，在web管理后台，点击左侧菜单栏的菜单管理，添加“媒体库”菜单。

如下图所示：

导入后刷新页面，在uni-admin左侧菜单，可看到媒体库的菜单项，点击即可进入。

前端组件使用

媒体库可做为独立的组件使用，例如文章封面可以通过媒体库组件来选择图片，不需要每次都重新上传图片。

基本用法

uni-media-library 组件符合 easycom 组件规范，可以直接在页面中使用 uni-media-library 标签，以使用媒体库组件。

<template>
  <uni-media-library></uni-media-library>
</template>

API

UniMediaLibrary Props

UniMediaLibrary Events

SelectedMediaItems 说明

云对象 (uni-media-library-co)

在 uni-media-library-co 云对象中实现了对媒体资源的上报与删除功能。

配置@co-config

uni-media-library的云端配置文件统一使用uni-config-center管理。

初次使用时，新建配置文件， 路径为 uni_modules/uni-config-center/uniCloud/cloudfunctions/common/uni-config-center/uni-media-library/config.json，用于配置uni-media-library相关信息，完整配置如下:

注意：以下注释仅用于对字段进行描述，复制时请删除注释。

{
  "cropMediaAssets": false, // 是否对媒体库的图片进行裁剪
}

媒体资源上报接口

接口名：report

接口形式

await uniMediaLibrary.report({
  src,
  cover,
  type,
  originalName,
  fileType,
  size,
  resolution,
  duration,
  uploadUser,
})

参数说明

Resolution说明

返回值

删除媒体资源

接口名：deleteMedia

接口形式

await uniMediaLibrary.deleteMedia({
  mediaIds
})

参数说明

返回值

注意

• 删除媒体资源时将会同时删除云存储文件，删除后将无法恢复，请谨慎操作。

uni-media-library Schema 扩展

负责处理与媒体库资源创建时的逻辑

主要功能有：

在读取（afterRead）媒体库资源后，根据uni-media-library配置文件中的cropMediaAssets字段，对图片进行裁剪。

注意事项

优化媒体库图片加载速度

默认媒体库加载图片会加载原图展示，同时会造成不必要的CDN流量消耗，可以通过uni-media-library云对象的配置文件开启图片裁剪(cropMediaAssets)，以优化图片加载速度。

具体配置参考uni-media-library-co配置

注意

根据您开通的服务空间不同，图片裁剪的功能也不同，具体如下：

• 阿里云图片裁剪目前可免费使用，无需担心费用问题。
• 腾讯云图片裁剪为付费服务，如使用腾讯云，建议您在使用前先了解腾讯云的计费规则，避免造成不必要的费用。

关于云存储数据处理，阿里云请参考数据处理， 腾讯云请参考数据万象。