[iOS] PHPhotoLibrary.requestAuthorization(_:) に入った変更 @iOS14

環境＆対象

PHPhotoLibrary

いわゆる “写真” アプリのデータへアクセスするためのフレームワークです。

UIImagePickerController

iOS14 以前では、UIImagePickerController を使用して、写真選択の UI を表示していました。

この UI を表示するためには、ユーザーから事前に許諾をもらう必要があり、そのための API が requestAuthorization でした。

以下のように使っていました。

        if PHPhotoLibrary.authorizationStatus() != .authorized {
            PHPhotoLibrary.requestAuthorization { status in
                if status == .authorized {
                    // ok to access
                } else if status == .denied {
                    // rejected....
                }
            }
        }

以前に許諾されたことがないと以下のような UI が表示されました。（見たことある人多いと思います。）

AuthorizationScreen

# PhotoAlbum という名前のサンプルアプリで動かしたので、少し混乱するかもしれません。

PHPickerViewController

iOS14 以降は、ユーザーが明示的に許諾せずとも、必要なデータにだけアプリからもアクセスできるようにする PHPickerViewController が用意されました。

この PHPickerViewController を使う時には、ユーザーへの許諾リクエストは不要です。（内部的にも、Picker は別プロセスで動作し、ユーザーが選択したものだけをアプリに渡すようになっています。）

[SwiftUI] UIImagePickerController を SwiftUI から使う方法

PHPhotoLibrary.requestAuthorization

iOS13 まで

以前の PHPhotoLibrary.requestAuthorization には、引数は、completion closure だけでした。

Apple のドキュメントは、こちら。

ドキュメントを確認するとわかりますが、iOS 14.0 で deprecated になってます。

iOS14 以降

iOS14 以降では、引数違いで同名の API が用意されています。

Apple のドキュメントは、こちら。

例によって（？）、”No overview available.” なドキュメントですが、以前のものから使い方は大きくは変わっていないように見えます。

追加された引数で指定できるのは、以下のものです。

• PHAccessLevelAddOnly
• PHAccessLevelReadWrite

Info.plist に登録することが必要なキー “Privacy – Photo Library Usage Description” と ”Privacy – Photo Library Additions Usage Description” に対応づいているように見えます。

フォトライブラリを読み出すだけなのか、追加するのかの違いのようです。

確認していませんが、おそらく対応するキーが登録されていないとエラーになる気がします。

上記の引数は、iOS14 で追加された API に追加された引数ですが、completion closure(handler) に渡される値も少し変わっていました。

completion closure

iOS13 以前、iOS14 以降 いずれも、closure の定義は、以下のようになっています。

handler: @escaping (PHAuthorizationStatus) -> Void)

変更は、PHAuthorizationStatus の定義にありました。

PHAuthorizationStatus　のとりえる値は以下のようになっています。

• .notDetermined : まだ確認していない状態
• .restricted : ユーザーが許諾する権限を持っていない状態
• .denied : 許可しなかった状態
• .authorized : 許可した状態
• .limited : 一部のみ許可した状態

最後の、.limited が、iOS14 になって追加されたものです。

新しいオプション .limited とは？

新しく追加された .limited オプションは、一部のみ許可した状態 です。

問題は、この 「一部」 が、過去に一度選択した写真 を意味していることです。（アプリごとに管理されていると思われます）

アプリで、再度写真を選択しようとしても、過去に選んだ写真しか選択できません。

この 過去に一度選択した写真 を変更するためには、以下の手順を必要とするようです。

まとめ：PHPhotoLibrary.requestAuthorization の変更点@ iOS14

説明は以上です。
不明な点やおかしな点ありましたら、こちらまで。

関連記事:

[Photos][Combine] requestAuthorization を Combine と組み合わせて使う [SwiftUI] SwiftUI から PHPicker を使用する方法 [iOS][macOS][PhotoKit] PhotoKit のセットアップ async/await 対応板 [SwiftUI] UIImagePickerController を SwiftUI から使う方法