HXPhotoPicker 技术文档

HXPhotoPicker 技术文档

HXPhotoPicker 图片/视频选择器 - 支持LivePhoto、GIF图片选择、3DTouch预览、在线下载iCloud上的资源、编辑图片/视频、浏览网络图片 功能 Imitation wx photo/image picker - support for LivePhoto, GIF image selection, 3DTouch preview, Download the resources on iCloud online, browse the web image function 项目地址: https://gitcode.com/gh_mirrors/hx/HXPhotoPicker

功能概述

HXPhotoPicker是一款强大的多媒体选择库，专注于图片与视频的选择，支持LivePhotos、GIF图像、在线资源下载以及编辑功能。它适应多种场景，提供了深度定制的可能性，包括UI外观的设置、多平台兼容性、国际化支持等，为开发者提供了一站式的多媒体处理解决方案。

安装指南

Swift Package Manager

对于使用Xcode 12.0及以上版本的项目，可以通过Swift Package Manager进行安装：

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

CocoaPods

如果你的项目已经集成了CocoaPods，可以在Podfile中添加对应的依赖：

pod 'HXPhotoPicker'

对于更细粒度的需求，如仅需要选择器或者编辑器部分，可以参考以下命令：

pod 'HXPhotoPicker/Picker'       # 仅选择器
pod 'HXPhotoPicker/Editor'      # 仅编辑器

准备应用

确保Info.plist文件中加入必要的权限描述，以便于在用户设备上请求访问：

• NSPhotoLibraryUsageDescription：允许访问相册。
• NSPhotoLibraryAddUsageDescription：允许保存图片至相册。
• PHPhotoLibraryPreventAutomaticLimitedAccessAlert：对于iOS 14+，设置为YES以禁用自动弹出提示。
• NSCameraUsageDescription 和 NSMicrophoneUsageDescription：如果使用相机功能。

使用说明

快速集成

首先，导入框架：

import HXPhotoPicker

接着，在你需要呈现图片选择的地方调用：

func presentPickerController() {
    let config = PickerConfiguration.default
    Photo.picker(config) { result, pickerController in
        switch result {
        case .success(let photoAssets):
            // 处理选择的图片或视频
            for asset in photoAssets {
                // 使用asset对象进一步操作
            }
        case .cancel:
            // 用户取消选择
        }
    } cancel: { pickerController in
        // 取消操作的处理
    }
}

实现PhotoPickerControllerDelegate来接收选择事件：

extension ViewController: PhotoPickerControllerDelegate {
    func pickerController(_ pickerController: PhotoPickerController, didFinishSelection result: PickerResult) {
        // 获取选择的图片或视频，并进行相应处理
    }
    
    func pickerController(didCancel pickerController: PhotoPickerController) {
        // 用户取消选择时的处理逻辑
    }
}

API使用

获取资源数据

• 获取UIImage：

  try await photoAsset.object() as UIImage
  

• 获取URL：

  try await photoAsset.object() as URL
  

• 或者通过同步的方式调用相应的getter方法。

编辑功能

HXPhotoPicker不仅支持选择，还内置了编辑功能，允许对图片进行裁剪、滤镜、涂鸦等操作。具体使用需参照框架提供的编辑接口和示例代码。

总结

通过上述步骤，您可以轻松地在您的应用中集成HXPhotoPicker，提供给用户丰富且流畅的多媒体选择体验。记得调整和测试以满足您的特定应用需求，并遵循Apple的人口统计学使用规则来正确请求用户权限。

HXPhotoPicker 图片/视频选择器 - 支持LivePhoto、GIF图片选择、3DTouch预览、在线下载iCloud上的资源、编辑图片/视频、浏览网络图片 功能 Imitation wx photo/image picker - support for LivePhoto, GIF image selection, 3DTouch preview, Download the resources on iCloud online, browse the web image function 项目地址: https://gitcode.com/gh_mirrors/hx/HXPhotoPicker