Skip to content

PHPickerFilter ​

PHPickerFilter 表示选图界面里显示哪些类型,比如只显示图片、只显示视频、图片里去掉截屏。把它写进 PHPickerConfiguration 的 filter。

现成的十二个筛选条件从类上读,三个静态方法把它们组合成新的条件,组合可以嵌套。

要先装 @nacrejs/photos,装法见 PHPickerViewController,也可以看核心和能力包。

继承关系:NSObject → PHPickerFilter

构造函数 ​

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

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

筛选条件从下面的静态属性和静态方法得到。

静态属性 ​

全部只读。每个每次读都是同一个对象。

属性显示什么
PHPickerFilter.imagesFilter图片,包括实况照片
PHPickerFilter.videosFilter视频
PHPickerFilter.livePhotosFilter实况照片
PHPickerFilter.depthEffectPhotosFilter带景深效果的照片(人像模式拍的)
PHPickerFilter.burstsFilter连拍
PHPickerFilter.panoramasFilter全景照片
PHPickerFilter.screenshotsFilter截屏
PHPickerFilter.screenRecordingsFilter屏幕录制
PHPickerFilter.cinematicVideosFilter电影效果模式拍的视频
PHPickerFilter.slomoVideosFilter慢动作视频
PHPickerFilter.timelapseVideosFilter延时摄影
PHPickerFilter.spatialMediaFilter空间照片和空间视频

静态方法 ​

方法得到的筛选条件
PHPickerFilter.anyFilterMatchingSubfilters()符合其中任何一个的
PHPickerFilter.allFilterMatchingSubfilters()每一个都符合的
PHPickerFilter.notFilterOfSubfilter()不符合这一个的

实例方法 ​

方法说明
isEqual()两个筛选条件是不是同一个意思

比较两个筛选条件 ​

比较两个筛选条件用 isEqual(),不要用 ===:

  • 现成的十二个每次读是同一个对象,=== 比得出来。
  • 组合出来的每次是新对象。同样的组合建两次,=== 是 false,isEqual() 是 true。
  • 配置的 filter 读回来的不是写进去的那个对象:系统存的是一份副本。

示例 ​

js
const config = new PHPickerConfiguration();
// 图片,但不要截屏
config.filter = PHPickerFilter.allFilterMatchingSubfilters([
  PHPickerFilter.imagesFilter,
  PHPickerFilter.notFilterOfSubfilter(PHPickerFilter.screenshotsFilter),
]);

效果:用这份配置建的选图界面里有照片,没有截屏,也没有视频。屏幕上的效果未在模拟器验证。

对应的 iOS API ​

ObjCJS
PHPickerFilter.imagesFilterPHPickerFilter.imagesFilter
[PHPickerFilter anyFilterMatchingSubfilters:@[a, b]]PHPickerFilter.anyFilterMatchingSubfilters([a, b])
[PHPickerFilter allFilterMatchingSubfilters:@[a, b]]PHPickerFilter.allFilterMatchingSubfilters([a, b])
[PHPickerFilter notFilterOfSubfilter:a]PHPickerFilter.notFilterOfSubfilter(a)
[a isEqual:b]a.isEqual(b)

参见 ​