更新记录

0.0.2（2025-04-12）

修改文档

0.0.1（2025-04-12）

更新日志

1.0.0（2025-04-12）

项目提交

平台兼容性

iboxs-choosemedia

开发文档

// 本插件仅测试过在uniappx上的反应，使用uniappx，不支持vue2，使用kotlin混编 //本插件尚未在生产环境进行测试，目前正在作者的项目里使用，项目尚未上线，请先行下载试用，检查无误再购买使用（需要自定义基座）

• 本插件需要文件读写权限及相机权限：

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
  <uses-permission android:name="android.permission.CAMERA" />

• 使用前，请注册两个页面：(这两个页面就是内部用于选择图片和预览图片的)

  {
  "path": "uni_modules/iboxs-choosemedia/pages/choose",
  "style": {
      "navigationBarTitleText": "选择图片",
      "navigationStyle": "custom",
      "navigationBarTextStyle": "white",
      "backgroundColorContent": "#484848"
  }
  },
  {
  "path" : "uni_modules/iboxs-choosemedia/pages/preview",
  "style" : 
  {
      "navigationBarTitleText": "预览图片",
      "navigationStyle": "custom",
      "navigationBarTextStyle": "white",
      // "hideBottomNavigationIndicator": true,
      "hideStatusBar": true,
      "backgroundColorContent": "#000"
  }
  }

• 本插件具备以下接口和功能

  • 选择媒体文件（目前支持选择图片/视频）【chooseImage(chooseOptions)】

import { chooseImage } from '@/uni_modules/iboxs-choosemedia';
chooseImage({
    type:'image',    //限制媒体（image为选择图片，video为选择视频，all为选择图片和视频）
    count:count,    //最大选择数量（不传为不限制）
    camera:false,  //是否支持直接拍照
    compress:0,  //0显示原图选款，用户决定，1为不显示直接压缩，2为不显示返回原图
    success(res:UTSJSONObject[]) {
        console.log('收到页面回调',res); 
        this.list=res;
        that.$forceUpdate()
    },
    fail(reson:String) {
        uni.showToast({
            title:reson,
            icon:'error'
        });
    }
} as chooseOptions)

    * 响应参数（utsjsonobject[]类型）

{
    from:'camera',  //来源(camera为相机拍摄，album为从相册中选择的)
    compress:true,  //文件是否被压缩（false为原图，true为压缩过）
    type:"image",   //文件类型（image图片，video视频）
    uri:uri,        //文件链接
    thumb:uri,      //缩略图地址（图片为与uri参数一致，视频为视频的缩略图）
    ext:'png',   //文件扩展名
    duration:0   //视频时长（图片返回0，视频为视频时长，单位秒）
}

* 预览图片【previewImage(previewOptions)】

for(var it in mediaList){
    queryList.push({
        type:it.type,     //预览的文件类型（image图片，video视频）
        uri:it.file as String  //预览的文件地址（图片或者视频）
    } as previewMedia);
}
previewImage({
    list:queryList
});

其他更多样式、页面使用方法和参数，请参考示例项目。