PictureSelector

KO | EN

gitlite — search

#python #hacktoberfest #ai #llm #golang #go #machine-learning #rust #deep-learning #docker #awesome #cli #openai #open-source

PictureSelector

(★ 14)

一个仿Android 13原生UI功能的图片选择器

PictureSelector Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PictureSelector 4.0
 一款针对Android平台下仿安卓13弹窗式的图片选择器，支持从相册获取图片、视频、音频，支持裁剪(单图or多图裁剪)等功能，支持动态获取权限&适配Android 5.0+系统的开源图片选择框架。

[效果体验](https://github.com/peihua8858/PictureSelector/raw/master/demo/demo_2023-11-10_1721_v4.0.0.apk)

[![Jitpack](https://jitpack.io/v/peihua8858/PictureSelector.svg)](https://github.com/peihua8858)
[![PRs Welcome](https://img.shields.io/badge/PRs-Welcome-brightgreen.svg)](https://github.com/peihua8858)
[![Star](https://img.shields.io/github/stars/peihua8858/PictureSelector.svg)](https://github.com/peihua8858/PictureSelector)

## 目录
-[最新版本](https://github.com/peihua8858/PictureSelector/releases/tag/4.0.0) 
-[如何引用](#如何引用) 
-[进阶使用](#进阶使用) 
-[权限](#权限) 
-[演示效果](#演示效果) 
-[混淆配置](#混淆配置) 
-[如何提Issues](https://github.com/peihua8858/PictureSelector/wiki/%E5%A6%82%E4%BD%95%E6%8F%90Issues%3F) 
-[License](#License)

## 如何引用
* 把 `maven { url 'https://jitpack.io' }` 加入到 repositories 中
* 添加如下依赖，末尾的「latestVersion」指的是PictureSelector [![Download](https://jitpack.io/v/peihua8858/PictureSelector.svg)](https://jitpack.io/#peihua8858/PictureSelector) 里的版本名称，请自行替换。
使用Gradle
```sh
repositories {
  google()
  maven { url 'https://jitpack.io' }
}

dependencies {
  // PictureSelector
  implementation 'com.github.peihua8858:PictureSelector:${latestVersion}'
}
```

或者Maven:

```xml
<dependency>
 <groupId>com.github.peihua8858</groupId>
 <artifactId>pictureselector</artifactId>
 <version>${latestVersion}</version>
</dependency>
```

## 权限

权限使用说明，请参阅 [文档](https://github.com/peihua8858/PictureSelector/wiki/PictureSelector-4.0-%E6%9D%83%E9%99%90%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E)

```xml
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

<-- Android 13版本适配，细化存储权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
```

Android 11 使用相机，需要再AndroidManifest.xm 添加如下代码：

```xml
<queries package="${applicationId}">
 <intent>
 <action android:name="android.media.action.IMAGE_CAPTURE">

</action>
 </intent>
 <intent>
 <action android:name="android.media.action.ACTION_VIDEO_CAPTURE">

</action>
 </intent>
</queries>
```

## ImageEngine
[RatioImageView](https://github.com/peihua8858/ImageLoader/blob/master/imageloader/src/main/java/com/fz/imageloader/widget/RatioImageView.kt) 
[ImageLoader](https://github.com/peihua8858/ImageLoader/blob/master/imageloader/src/main/java/com/fz/imageloader/ImageLoader.kt)

## 进阶使用

简单用例如下所示:

1、获取图片

```kotlin
//注册获取图片ActivityResultContract
private val takePictureLaunch = mActivity.registerForActivityResult(PhotoVisualMedia()) {
        if (it != null) {
           //todo 
        }
    }
//运行获取图片请求
//仅获取图片
takePictureLaunch.launch(PhotoVisualMediaRequest(PhotoVisualMedia.ImageOnly))
//获取图片及视频
takePictureLaunch.launch(PhotoVisualMediaRequest(PhotoVisualMedia.ImageAndVideo))
//仅获取视频
takePictureLaunch.launch(PhotoVisualMediaRequest(PhotoVisualMedia.VideoOnly))
//仅获取音频
takePictureLaunch.launch(PhotoVisualMediaRequest(PhotoVisualMedia.AudioOnly))
//仅获取mimeType指定的类型
takePictureLaunch.launch(PhotoVisualMediaRequest(PhotoVisualMedia.SingleMimeType(mimeType)))
//仅获取mimeTypes指定的类型
takePictureLaunch.launch(PhotoVisualMediaRequest(PhotoVisualMedia.MultipleMimeType(mimeTypes)))
```
2、裁剪图片
```kotlin
private val takeCropLaunch = mActivity.registerForActivityResult(PhotoCropVisualMedia()) {
        if (it.resultCode == Activity.RESULT_OK) {
            val intent = it.data
            val uri = if (intent?.data != null) {
                intent.data
            } else {
                val url = intent?.action
                if (url.isNonEmpty()) {
                    Uri.parse(url)
                } else null
            }
            if (uri != null) {
               //todo
            }
        }
    }
    val outputFile = "IMG_".createFile("jpg")
    val outputUri = Uri.fromFile(outputFile)
     takeCropLaunch.launch(
             PhotoCropVisualMediaRequestBuilder(uri, outputUri)
                    .withAspectRatio(1f, 1f)
                    .withMaxResultSize(200, 200)
                    .setCircleDimmedLayer(true)
                    .build()
            )

```

## 混淆配置 
```sh
-keep class com.peihua.selector.** { *; }
```

## 演示效果

|          单选图片          |           预览           |           相册           |
|:----------------------:|:----------------------:|:----------------------:|
| ![](https://raw.githubusercontent.com/peihua8858/PictureSelector/master/images/image1.jpg) | ![](https://raw.githubusercontent.com/peihua8858/PictureSelector/master/images/image7.jpg) | ![](https://raw.githubusercontent.com/peihua8858/PictureSelector/master/images/image3.jpg) |

|          多选图片          |           预览           |           相册           |
|:----------------------:|:----------------------:|:----------------------:|
| ![](https://raw.githubusercontent.com/peihua8858/PictureSelector/master/images/image5.jpg) | ![](https://raw.githubusercontent.com/peihua8858/PictureSelector/master/images/image8.jpg) | ![](https://raw.githubusercontent.com/peihua8858/PictureSelector/master/images/image9.jpg) |

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

PictureSelector

PictureSelector Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

PictureSelector

PictureSelector Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README