中文 | English

Please move to HXPhotoPicker for the latest version

photo/video selector-supports LivePhoto, GIF selection, iCloud resource online download, photo/video editing

Features

• UI Appearance supports light/dark/auto/custom
• Support multiple selection/mixed content selection
• Supported media types：
  • Photo
  • GIF
  • Live Photo
  • Video
• Supported local media types：
  • Photo
  • Video
  • GIF
  • Live Photo
• Supported network media types：
  • Photo
  • Video
• Support downloading assets on iCloud
• Support gesture back
• Support sliding selection
• Edit pictures (support animated pictures, network pictures)
  • Graffiti
  • Sticker
  • Text
  • Crop
  • Mosaic
  • Filter
• Edit video (support network video)
  • Graffiti
  • Stickers (support GIF)
  • Text
  • Soundtrack (support lyrics and subtitles)
  • Crop duration
  • Crop Size
  • Filter
• Album display mode
  • Separate list
  • Pop-ups
• Multi-platform support
  • iOS
  • iPadOS
• Internationalization support
  • 🇨🇳 Chinese, Simplified (zh-Hans)
  • 🇬🇧 English (en)
  • 🇨🇳 Chinese, traditional (zh-Hant)
  • 🇯🇵 Japanese (ja)
  • 🇰🇷 Korean (ko)
  • 🇹🇭 Thai (th)
  • 🇮🇳 Indonesian (id)
  • 🇻🇳 Vietnamese (vi)
  • 🇷🇺 russian (ru)
  • 🇩🇪 german (de)
  • 🇫🇷 french (fr)
  • 🇸🇦 arabic (ar)
  • ✍️ Custom language (custom)
  • 🤝 More support... (Pull requests welcome)

Requirements

• iOS 12.0+
• Xcode 12.5+
• Swift 5.4+

Installation

Swift Package Manager

⚠️ Needs Xcode 12.0+ to support resources and localization files

dependencies: [
    .package(url: "https://github.com/SilenceLove/HXPHPicker.git", .upToNextMajor(from: "2.0.0"))
]

CocoaPods

Add this to Podfile, and then update dependency:

iOS 12.0+
pod 'HXPHPicker'

/// No Kingfisher
pod `HXPHPicker/Lite`

/// Only Picker
pod `HXPHPicker/Picker`
pod `HXPHPicker/Picker/Lite`

/// Only Editor
pod `HXPHPicker/Editor`
pod `HXPHPicker/Editor/Lite`

/// Only Camera
pod `HXPHPicker/Camera`
/// Does not include location functionality
pod `HXPHPicker/Camera/Lite`

iOS 10.0+
pod 'HXPHPicker-Lite'
pod 'HXPHPicker-Lite/Picker'
pod 'HXPHPicker-Lite/Editor'
pod 'HXPHPicker-Lite/Camera'

Carthage

Add the following content to Cartfile and perform dependency update.

github "SilenceLove/HXPHPicker"

Usage

Wiki

Prepare

Add these keys to your Info.plist when needed:

Key	Module	Info
NSPhotoLibraryUsageDescription	Picker	Allow access to album
NSPhotoLibraryAddUsageDescription	Picker	Allow to save pictures to album
PHPhotoLibraryPreventAutomaticLimitedAccessAlert	Picker	Set YES to prevent automatic limited access alert in iOS 14+ (Picker has been adapted with Limited features that can be triggered by the user to enhance the user experience)
NSCameraUsageDescription	Camera	Allow camera
NSMicrophoneUsageDescription	Camera	Allow microphone

Quick Start

import HXPHPicker

class ViewController: UIViewController {

    func presentPickerController() {
        // Set the configuration consistent with the WeChat theme
        let config = PickerConfiguration.default
        
        // Method 1：
        let pickerController = PhotoPickerController(picker: config)
        pickerController.pickerDelegate = self
        // The array of PhotoAsset objects corresponding to the currently selected asset
        pickerController.selectedAssetArray = selectedAssets 
        // Whether to select the original image
        pickerController.isOriginal = isOriginal
        present(pickerController, animated: true, completion: nil)
        
        // Method 2：
        Photo.picker(
            config
        ) { result, pickerController in
            // Select completion callback
            // result Select result
            //  .photoAssets Currently selected data
            //  .isOriginal Whether the original image is selected
            // photoPickerController Corresponding photo selection controller
        } cancel: { pickerController in
            // Cancelled callback
            // photoPickerController Corresponding photo selection controller
        }
    }
}

extension ViewController: PhotoPickerControllerDelegate {
    
    /// Called after the selection is complete
    /// - Parameters:
    ///   - pickerController: corresponding PhotoPickerController
    ///   - result: Selected result
    ///     result.photoAssets  Selected asset array
    ///     result.isOriginal   Whether to select the original image
    func pickerController(_ pickerController: PhotoPickerController, 
                            didFinishSelection result: PickerResult) {
        result.getImage { (image, photoAsset, index) in
            if let image = image {
                print("success", image)
            }else {
                print("failed")
            }
        } completionHandler: { (images) in
            print(images)
        }
    }
    
    /// Called when cancel is clicked
    /// - Parameter pickerController: Corresponding PhotoPickerController
    func pickerController(didCancel pickerController: PhotoPickerController) {
        
    }
}

Get Content

Get UIImage

/// If it is a video, get the cover of the video
/// compressionQuality: Compress parameters, if not passed, no compression
photoAsset.getImage(compressionQuality: compressionQuality) { image in
    print(image)
}

Get URL

/// compression: Compress parameters, if not passed, no compression
photoAsset.getURL(compression: compression) { result in
    switch result {
    case .success(let urlResult): 
        
        switch urlResult.mediaType {
        case .photo:
        
        case .video:
        
        }
        
        switch urlResult.urlType {
        case .local:
        
        case .network:
        
        }
        
        print(urlResult.url)
        
        // Image and video urls contained in LivePhoto
        print(urlResult.livePhoto) 
        
    case .failure(let error):
        print(error)
    }
}

Release Notes

Version	Release Date	Xcode	Swift	iOS
v2.0.0	2023-06-14	14.3.0	5.7.0	12.0+
v1.4.6	2022-11-20	14.0.0	5.7.0	12.0+

License

HXPHPicker is released under the MIT license. See LICENSE for details.

Support

• ★ Star this repo.
• Support with

or

Stargazers over time

🔝