如何快速集成UnityNativeGallery到你的项目？新手入门教程
项目地址: https://gitcode.com/gh_mirrors/un/UnityNativeGallery UnityNativeGallery是一款强大的原生Unity插件，专为Android和iOS平台设计，能够帮助开发者轻松实现与设备相册/照片库的交互，包括保存和加载图片、视频等功能。本教程将为你提供简单快速的集成步骤，让你在项目中迅速用上这一实用工具。
📋 准备工作：获取UnityNativeGallery
首先，你需要将UnityNativeGallery插件添加到你的Unity项目中。你可以通过以下方式获取：
- 打开终端，使用git命令克隆仓库：
git clone https://gitcode.com/gh_mirrors/un/UnityNativeGallery
- 将克隆下来的文件夹中的内容导入到你的Unity项目中。
📱 iOS平台配置步骤
iOS平台需要进行一些额外的配置才能确保UnityNativeGallery正常工作。
添加隐私权限描述
- 在Unity中构建iOS项目后，用Xcode打开生成的项目。
- 选择项目中的"Unity-iPhone"目标，切换到"Info"标签页。
- 添加以下隐私权限描述：
Privacy - Photo Library Usage Description：说明为什么需要访问照片库
图：在Xcode中配置UnityNativeGallery的iOS隐私权限
配置链接框架
- 在Xcode项目中，切换到"Build Settings"标签页。
- 在"Linking"部分找到"Other Linker Flags"。
- 添加以下框架链接：
-weak_framework Photos -framework AssetsLibrary -framework MobileCoreServices -framework ImageIO
图：在Xcode中配置UnityNativeGallery的链接框架
🤖 Android平台配置步骤
相比iOS，Android平台的配置相对简单：
- UnityNativeGallery已经包含了必要的AndroidManifest配置。
- 插件中的NativeGallery.aar文件已经包含了所有需要的原生代码和权限声明。
🚀 开始使用UnityNativeGallery
集成完成后，你就可以在代码中使用UnityNativeGallery的功能了。主要的API都在NativeGallery.cs文件中。
以下是一些常用功能的简单示例：
保存图片到相册
// 保存纹理到相册
NativeGallery.SaveImageToGallery(texture, "MyApp", "my_image.jpg");
从相册选择图片
// 打开相册选择图片
NativeGallery.PickImage((path) => {
if (!string.IsNullOrEmpty(path))
{
// 加载选中的图片
Texture2D texture = NativeGallery.LoadImageAtPath(path);
}
});
📚 更多资源
- 插件详细文档：README.txt
- 运行时代码：NativeGallery.Runtime.asmdef
- iOS平台回调处理：NGMediaReceiveCallbackiOS.cs
- Android平台回调处理：NGMediaReceiveCallbackAndroid.cs
通过以上步骤，你已经成功将UnityNativeGallery集成到你的项目中。这个强大的插件将帮助你轻松实现与设备相册的交互，为你的Unity应用增添更多实用功能！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
