Skip to content

PHPhotoLibrary ​

PHPhotoLibrary 表示系统的相册。App 用它把一张图存成相册里的一张新照片。

往相册里存图要用户同意「添加照片」的权限。没问过用户时,存图的方法自己会先弹提示框。

要先装 @nacrejs/photos,并且在 nacre.config.json 里写 NSPhotoLibraryAddUsageDescription,装法见 PHPickerViewController,也可以看核心和能力包。

继承关系:NSObject → PHPhotoLibrary

构造函数 ​

不能用 new 创建。new PHPhotoLibrary() 抛 TypeError:

Illegal constructor: PHPhotoLibrary is created by the runtime, not by new

整个 App 只有一个,从 PHPhotoLibrary.sharedPhotoLibrary 读。

静态属性 ​

PHPhotoLibrary.sharedPhotoLibrary 只读

系统的相册。两次读是同一个对象。

静态方法 ​

方法说明
PHPhotoLibrary.authorizationStatusForAccessLevel()读现在的授权状态,不弹提示框
PHPhotoLibrary.requestAuthorizationForAccessLevel()申请权限,返回 Promise

实例方法 ​

方法说明
performChanges()修改相册:存一张新照片

授权状态 ​

取值含义
'notDetermined'还没问过用户
'authorized'用户同意了
'denied'用户拒绝了
'restricted'被系统限制了(家长控制一类),用户自己也改不了
'limited'用户只给了一部分照片。'addOnly' 这个级别不会出现

系统只问用户一次。用户拒绝过之后 App 不能再弹提示框,只能请用户到系统的「设置」里打开。状态变了没有事件:用户只能在提示框里或者离开 App 到「设置」里改它,所以在要用的时候读一次。

错误 ​

performChanges() 和 requestAuthorizationForAccessLevel() 的 Promise 被拒绝时得到一个 Error,类型定义里叫 PHPhotoLibraryError。上面多两个字段:code(number)和 domain(string),是系统给的错误码和错误域。

name什么时候
NotAllowedError用户没同意,或者被系统限制了
InvalidStateError工程里没写 NSPhotoLibraryAddUsageDescription。用 CLI 生成的工程不会出现,生成时就拦住了
PhotosError别的失败,比如存储空间不够。具体原因看 message 和 code

各种情况下的 code 和 domain 未在模拟器验证。

示例 ​

js
const photo = UIImage.imageNamed('JS/assets/photo');
if (photo !== null) {
  try {
    await PHPhotoLibrary.sharedPhotoLibrary.performChanges({
      creationRequestForAssetFromImage: photo,
    });
    console.log('存好了');
  } catch (err) {
    console.log('没存成:' + /** @type {Error} */ (err).name);
  }
}

效果(未在模拟器验证):第一次调用时系统弹权限提示框,上面是 nacre.config.json 里写的那句话。点「允许」,控制台输出 存好了,系统的「照片」App 里多一张图。点「不允许」,输出 没存成:NotAllowedError。

对应的 iOS API ​

ObjCJS
PHPhotoLibrary.sharedPhotoLibraryPHPhotoLibrary.sharedPhotoLibrary
[PHPhotoLibrary authorizationStatusForAccessLevel:PHAccessLevelAddOnly]PHPhotoLibrary.authorizationStatusForAccessLevel('addOnly')
[PHPhotoLibrary requestAuthorizationForAccessLevel:PHAccessLevelAddOnly handler:^(PHAuthorizationStatus status) { … }]await PHPhotoLibrary.requestAuthorizationForAccessLevel('addOnly')
[library performChanges:^{ [PHAssetChangeRequest creationRequestForAssetFromImage:image]; } completionHandler:^(BOOL success, NSError *error) { … }]await library.performChanges({ creationRequestForAssetFromImage: image })

最后一行形状不一样。ObjC 的第一个参数是一段代码,要做的修改写在代码里;JS 这边是一个对象,键是要做的那种修改的名字。

参见 ​