# @baronha/react-native-multiple-image-picker 中文文档 规范地址：https://npmcn.com/package/%40baronha/react-native-multiple-image-picker/ 版本：2\.2\.5 npm 元数据更新时间：2025-12-10T17:48:55.618Z 中文译文更新时间：2026-11-07T17:11:43.738Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40baronha/react-native-multiple-image-picker 原文对照：https://npmcn.com/package/%40baronha/react-native-multiple-image-picker/?lang=original 项目主页：https://github.com/NitrogenZLab/react-native-multiple-image-picker#readme 源码仓库：https://github.com/NitrogenZLab/react-native-multiple-image-picker ## 关键信息（来自 npm 元数据） - 包体积（解压后）：509 kB，240 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - 运行依赖：0 个 - peer 依赖：react \*，react-native \* - 首次发布：2021-02-22T04:23:41.467Z - 最新版本发布：2025-12-10T17:48:55.433Z - 近 30 天下载量：9860（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：62（近 12 个月 1 个） ## 中文简介 反应-内生-多图像-取相器使应用程序能够从iOS/Android的多张智能相册中取出图像和视频 ## 安装 ```sh npm install @baronha/react-native-multiple-image-picker ``` 也可以使用：`pnpm add @baronha/react-native-multiple-image-picker`、`yarn add @baronha/react-native-multiple-image-picker`、`bun add @baronha/react-native-multiple-image-picker` ## README ![Logo](https://img.shields.io/badge/React_Native_Multiple_Image_Picker-DF78C3?style=for-the-badge) ![](https://npmcn.com/package/%40baronha/react-native-multiple-image-picker/files/banner.png) [![iOS](https://img.shields.io/badge/iOS-000000?style=for-the-badge&logo=ios&logoColor=white)](https://www.apple.com/ios) [![Android](https://img.shields.io/badge/Android-3DDC84?style=for-the-badge&logo=android&logoColor=white)](https://www.android.com/) [![Swift](https://img.shields.io/badge/Swift-FA7343?style=for-the-badge&logo=swift&logoColor=white)](https://developer.apple.com/swift/) [![Kotlin](https://img.shields.io/badge/Kotlin-0095D5?&style=for-the-badge&logo=kotlin&logoColor=white)](https://kotlinlang.org/) [![React-Native](https://img.shields.io/badge/React_Native-20232A?style=for-the-badge&logo=react&logoColor=61DAFB)](https://reactnative.dev/) ## 概览 [https://github.com/user-attachments/assets/79580bc7-237c-46b7-b92e-1479cc6d9079 互联网档案馆的存檔,存档日期2014-12-29](https://github.com/user-attachments/assets/79580bc7-237c-46b7-b92e-1479cc6d9079) 反应原生多相图像拾取器 **(RNMIP) (英语)** 允许应用程序从 iOS/Android 的多张智能相册中选择图像和视频. React Independent Multime Picker基于两个可用的库, [HXPhoto 选择器](https://github.com/SilenceLove/HXPhotoPicker) 财务报告和审定财务报表 [图片选择器](https://github.com/LuckSiege/PictureSelector) ## 页:1 ## 特征 | 🤩 | ![Logo](https://img.shields.io/badge/React_Native_Multiple_Image_Picker-DF78C3?style=for-the-badge) | | --- | --- | | 🍕 | [**作物**](https://npmcn.com/docs/docs/CROP.mdx) 单相/多相图像. | | 🎑 | [**预览**](https://npmcn.com/docs/docs/PREVIEW.mdx) 图像/视频. | | 📸 | [**相机**](https://npmcn.com/docs/docs/CAMERA.mdx) 用于捕捉相片和录制相片的模块. | | 🐳 | 保留上一个选择 . | | ️⃣ | 所选顺序索引 . | | 🎨 | UI 自定义( Column, 间隔, 主颜色. ) | | 🌚 | 暗模式、 淡模式 | | 🌄 | 选择多个图像/视频 . | | 📦 | 支持智能相册 `(camera roll, selfies, panoramas, favorites, videos...)`。 。 。 . | | 📺 | 显示视频持续时间 . | | ⛅️ | 支持 iCloud 照片库 . | | 🌪 | 滚动性能 | ## 所需资源 由于RNMIP使用硝基模组,因此符合硝基模组的要求. 查看硝基模块的要求 [这里](https://nitro.margelo.com/docs/minimum-requirements) - `Xcode 16+` - `iOS 13+` - `react-native 0.75+` - `compileSdkVersion 34+` ## 安装 看见更多 [**安装**](https://nitrogenzlab.github.io/react-native-multiple-image-picker/getting-started) ## 使用量 以下是多相取影器的简单用法. 看见更多 [**配置**](https://nitrogenzlab.github.io/react-native-multiple-image-picker/config) ```typescript import { openPicker, Config } from '@baronha/react-native-multiple-image-picker' const config: Config = { maxSelect: 10, maxVideo: 10, primaryColor: '#FB9300', backgroundDark: '#2f2f2f', numberOfColumn: 4, mediaType: 'all', selectBoxStyle: 'number', selectMode: 'multiple', language: 'vi', // 🇻🇳 Vietnamese theme: 'dark', isHiddenOriginalButton: false, primaryColor: '#F6B35D', } const onPicker = async () => { try { const response = await openPicker(config) setImages(response) } catch (e) { // catch error for multiple image picker } } ``` ## 待执行 - [x] 在iOS中裁剪图像. - [x] 预览控制器 `iOS`。 。 。 . - [x] 有限时处理权限 `iOS`。 。 。 . - [x] 将图书馆迁移到新建筑. - [x] 多裁剪图像. - [x] 多预览图像. - [x] 动态主题. - [x] 动态语言 - [x] 开放作物控制器. - [x] 打开预览控制器 . - [x] 打开相机控制器. ## 赞助和支持 [![BuyMeACoffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/baronha) [![Kofi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/baoha) 为了保持该图书馆的维持和更新,请考虑 [在GitHub上赞助](https://github.com/sponsors/baronha)或者,如果你寻求私人支持或帮助 定制经验,然后通过Twitter联系我 [巴伦哈](https://twitter.com/_baronha)。 。 。 . 此外,我还用HXPhotoPicker制造了一个产品,希望你支持: [![](https://github.com/user-attachments/assets/71b5ddf7-3da1-4091-aae6-9aa7e411ce75)](https://apps.apple.com/vn/app/binsoo-photo-filters-editor/id6502683720) ## 由 QQ 创建 [![NitroModules](https://img.shields.io/badge/Nitro_Modules-0052CC?style=for-the-badge)](https://nitro.margelo.com/docs/nitro-modules) [![HXPhotoPicker](https://img.shields.io/badge/HXPhotoPicker-F05138?style=for-the-badge)](https://github.com/SilenceLove/HXPhotoPicker) [![PictureSelector](https://img.shields.io/badge/Picture_Selector-b07219?style=for-the-badge)](https://github.com/LuckSiege/PictureSelector) ## 恒星历史 [![Star History Chart](https://api.star-history.com/svg?repos=baronha/react-native-multiple-image-picker&type=Date)](https://star-history.com/#bytebase/star-history&Date) ## 显示大小写 QQ 使用过的应用程序清单 `@baronha/react-native-multiple-image-picker` 欢迎捐款! 如果您的应用程序使用 `@baronha/react-native-multiple-image-picker`请打开一个 [拉动请求](https://npmcn.com/docs/docs/SHOWCASE/showcase.json) 将它添加到列表中. 见所有 [**显示大小写**](https://nitrogenzlab.github.io/react-native-multiple-image-picker/showcase) ## 业绩 我们正在努力提高性能。 如果你有更好的解决方案 请打开一个 [问题](https://github.com/NitrogenZLab/react-native-multiple-image-picker/issues) 或者说 [拉动请求](https://github.com/NitrogenZLab/react-native-multiple-image-picker/pulls)祝你们愉快! ## 许可证 麻省理工学院 [TLPhoto 选择器](https://github.com/tilltue/TLPhotoPicker/blob/master/LICENSE) [图片选择器](https://github.com/LuckSiege/PictureSelector/blob/master/LICENSE) ## 常见问题 ### @baronha/react-native-multiple-image-picker 是什么？ 反应-内生-多图像-取相器使应用程序能够从iOS/Android的多张智能相册中取出图像和视频 ### 如何安装 @baronha/react-native-multiple-image-picker？ 在项目目录运行 npm install @baronha/react-native-multiple-image-picker，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\*）、react-native（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @baronha/react-native-multiple-image-picker 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @baronha/react-native-multiple-image-picker 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @baronha/react-native-multiple-image-picker 可以商用吗？ @baronha/react-native-multiple-image-picker 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @baronha/react-native-multiple-image-picker 的下载量有多少？ 根据 npm 官方下载统计，@baronha/react-native-multiple-image-picker 在 2026/10/08 – 2026/11/06 这 30 天内被下载 9,860 次，日均约 329 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @baronha/react-native-multiple-image-picker 还在维护吗？ 最新版本 2\.2\.5 发布于 2025/12/11（10 个月前）；至今共发布 62 个版本，其中过去 12 个月发布了 1 个；首次发布于 2021/02/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。