Tauri 插件 iOS 相片
访问和管理 Tauri 插件 iOS 相册和资产 使用本地相片框架.
这个插件允许Tauri应用程序请求照片权限,阅读相册,访问相片,并在iOS设备上进行基本的相册/相片管理.
只有iOS系统 此插件依赖于Apple Photos API,在其他平台上不可用.
特征
- 请求和检查照片库的授权
- 列出用户相册
- 访问相册相片
- 过滤相册
- 检查相册权限
- 创建并删除相册
- 创建、访问和删除相片
所需资源
- Tauri 2.x(或相容版本)
- 带有 iOS SDK 的 Xcode
- 配置适当的相片库权限
Info.plist
iOS 权限
此插件需要访问用户的照片库 .
请将以下密钥添加到您的 iOS系统 Info.plist数字 :
<key>NSPhotoLibraryUsageDescription</key>
<string>Allow access to your photo library</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>Allow saving photos to your photo library</string>
安装
pnpm add @gbyte/tauri-plugin-ios-photos
# or
npm install @gbyte/tauri-plugin-ios-photos
# or
yarn add @gbyte/tauri-plugin-ios-photos
在您的 Tauri 工程中添加插件 Cargo.toml数字 :
[dependencies]
tauri-plugin-ios-photos = "0.3"
或使用 cargo add tauri-plugin-ios-photos。 。 。 .
配置您的插件权限 capabilities/default.json数字 :
{
"permissions": [
"ios-photos:default"
]
}
在您的 Tauri 应用程序中注册插件 :
fn main() {
tauri::Builder::default()
.plugin(tauri_plugin_ios_photos::init())
.run(tauri::generate_context!())
.expect("error while running tauri application");
}
用法(概念示例)
import {
requestPhotosAuth,
PhotosAuthorizationStatus,
requestAlbums,
PHAssetCollectionType,
PHAssetCollectionSubtype
} from '@gbyte/tauri-plugin-ios-photos'
let photoAuth = ''
let albums = []
requestPhotosAuth()
.then((status) => {
switch (status) {
case PhotosAuthorizationStatus.authorized:
photoAuth = 'authorized'
break
case PhotosAuthorizationStatus.denied:
photoAuth = 'denied'
break
case PhotosAuthorizationStatus.limited:
photoAuth = 'limited'
break
case PhotosAuthorizationStatus.restricted:
photoAuth = 'restricted'
break
case PhotosAuthorizationStatus.notDetermined:
photoAuth = 'notDetermined'
break
}
})
.then(() => {
requestAlbums({
with: PHAssetCollectionType.smartAlbum,
subtype: PHAssetCollectionSubtype.albumRegular
}).then((value) => {
albums = value
})
})
关于图像路径访问
此插件返回的图像路径是本地文件路径, 通常指向内部的 iOS 沙盒位置 .
在Tauri(特别是在iOS/WebView环境中)中,这些本地路径无法由前端直接访问(例如通过文件://或原始文件系统路径). 这是由于WebView的安全和沙盒的限制.
在使用前端的这些图像之前, 您必须通过 Tauri 自定义协议( URI 方案) 来曝光它们, 这样它们就可以作为普通的 URL 访问 .
建议的办法:
-
在 Tauri 中注册一个自定义的 URI 方案( 例如, time://)
-
当前端请求临时 :
-
Tauri 读取相应的本地文件
-
以正确的 MIME 类型返回二进制数据
- 前端然后可以正常地使用URL(例如.
(中文(简体) )
注释 :
此插件不会自动将本地路径转换为可访问 URL
执行自定义协议是应用程序的责任
出于安全原因,建议限制无障碍路径范围
状况
可能的授权规定:
notDeterminedrestricteddeniedauthorizedlimited
插件会让API接触到查询并对这些状态作出反应.
待办事宜/ 路线图
- 请求访问授权
- 检查授权类型
- 列出用户设备相册
- 从相册取相片
- 过滤相册
- 检查相册权限
- 获取相片
- 创建相册
- 创建相片
- 删除相册
- 删除相片
- 删除相片
- 文件改进
- 示例项目
- 处理标准化出错
页:1
- 所有相片操作都遵循iOS隐私规则.
- 如果许可有限,一些行动可能会默默失败.
- 相册和相片识别符由系统生成.
许可证
麻省理工学院