「連絡先へのアクセス」ボタンについて

「連絡先へのアクセス」ボタンについて

連絡先へのアクセス許可の新しいモードについて説明し、アプリで連絡先へのアクセスを向上させる方法をご紹介します。「連絡先へのアクセス」ボタンをアプリに追加し、必要に応じて新しい連絡先を共有したり、連絡先へのアクセス許可を簡単に行えるようにしたりする方法を説明します。このボタンがアプリに適していない場合に使用する代わりのAPIや、連絡先のセキュリティ機能についても取り上げます。

関連する章
- 0:00 - Introduction
- 0:36 - Limited Access
- 2:56 - Contact Access Button
- 8:28 - Accessing contacts
- 13:34 - Which access method to use
リソース
ダウンロード

こんにちはAdaですこのセッションでは「連絡先へのアクセス」ボタンを簡単に紹介しアプリでの使い方も説明しますまず iOS 18で利用できる限定アクセス機能の概要を説明します次に新しいContactAccessButton APIについて説明しこのAPIによってアプリから連絡先を直接操作する便利な方法を紹介します最後に連絡先にアクセスするための別の方法とそれがアクセスの制限された状態でどう機能するかを説明します
iOS 18では連絡先へのアクセスを許可する際連絡先データベースの一部だけを共有するオプションが追加されましたこれを限定アクセスと呼びます連絡先への新しいアクセス許可は 2段階のプロンプトで行われます最初のアラートで連絡先をアプリと共有するかどうかが尋ねられますをタップすると 2つ目のプロンプトが表示され連絡先の共有に関する 2つのオプションが提示されますここでは共有する連絡先のセットを選択するかまたはアプリですべてのアクセスを許可するかを選択できますプロンプトではこれが最終的な選択ではないことと連絡先のセットは後から拡張できることが明示されます
目的の連絡先セットを選択すると選択した連絡先が確認画面に表示されますこの新しいアクセス許可フローによって連絡先のプライバシーが大幅に改善され透明性が高まり共有内容の管理性も向上します
この新機能には 4つの許可レベルがありますフルアクセスの場合アプリはすべての連絡先を読み取ることができ連絡先の変更や新規作成も行えます
限定アクセスの場合アプリはアクセスを許可された連絡先だけを読み取ることができますまたフルアクセスの場合と同様に連絡先の変更や新規作成も行えます
アプリは常に許可ステータスがの状態で起動します連絡先ストアにアクセスしようとすると許可プロンプトがモーダル形式で表示されます
アプリがアクセスを許可されていればアクセスは成功します
最後にアプリの許可レベルがの場合は連絡先データの読み書きができません
アクセスが制限された状態でも素晴らしい体験が得られるように iOS 18には追加の連絡先へのアクセスをアプリに許可するための 2つの新しいAPIが用意されています連絡先アクセスピッカーを使用するとアプリがどの連絡先にアクセスできるかをアプリを離れることなく簡単に変更できます
連絡先アクセスボタンはアプリ内で連絡先へのアクセスを管理できるパワフルな新しい方法です全画面表示のピッカーの代わりにこのボタンを既存のUIに組み込めば新しい連絡先へのアクセスをシングルタップで許可できますここまでで連絡先への基本的なアクセス方法を紹介しましたので次に限定アクセスを利用する最良の方法である連絡先アクセスボタンについて詳しく見ていきましょう ContactAccessButtonは追加の連絡先へのアクセスをアプリに許可するための合理的な方法です
このボタンをアプリの連絡先検索フローに追加するとアプリがまだアクセスを許可されていない連絡先の検索結果が表示されますボタンはアプリにシームレスに組み込まれるように設計されています
一意に一致する連絡先があればボタンを1回タップするだけでその連絡先へのアクセスがアプリに許可されますこれを使用すればフルアクセス許可がなくても完全な連絡先ピッカー機能をアプリ内で体験できます
限定アクセスに対するこうした段階的なアプローチは必要な時に必要な連絡先にアプリが確実にアクセスできることを意味しますその結果アプリでの連絡先の共有を安心して行えるようになります
アクセス許可を求める最良のタイミングはインタラクションのためアクセスが必要になった瞬間ですデータが必要になった時点で要求が行われればアクセスが許可された場合アプリがどのような機能を提供するのかが明確になります
連絡先アクセスボタンはこの原則に基づいて設計された機能ですこの機能を使用する場合は個々の連絡先を共有する明確な必要性がある時にアクセスを求めるワークフローに従ってアプリを方向付けることになります
ユーザーはこのボタンを使用するとどの連絡先を共有したいかを正確に理解している状況で決定を行えるためアプリでどの連絡先が必要になるかを推測する必要がありません
連絡先アクセスボタンはこのアイデアをさらに発展させたものでアプリの許可レベルがまだ未決定の状態でもボタンを表示できるのです
アプリがアクセスを許可される前にユーザーがボタンをタップすると限定アクセスを要求する簡易プロンプトが自動的に表示されますこの動作は連絡先の検索結果をタップした直後に行われるためアプリがなぜアクセスを必要としているのかわかりやすくアプリがアクセスを許可される可能性が高くなります
アプリ内でボタンを使用する例を見てみましょうこれはアプリで連絡先の検索結果を表示する単純なビューです
このビューはアプリの検索テキストフィールドに入力されたテキストとのバインディングを持ち
アプリの許可ステータスを追跡しています
最初にアプリが自身のデータストアから取得できる結果を表示してみます今回は単純なForEachを使用してこれを行います
アプリ自身の結果を得た後条件付きでつまりアプリの許可ステータスが「limited」または「notDetermined」の場合にのみ連絡先アクセスボタンを表示してみます
ボタンを初期化する際は検索フィールドに入力されたテキストを渡します
最後にコールバックブロックで連絡先のID文字列の配列を受け取りますこの時点で連絡先の詳細を取得できるため検索UIを消去できます
ボタンは標準のSwiftUIモディファイアを使用すればアプリの外観に合わせて調整できるように設計されています
fontモディファイアは上行のテキストと末尾のアクションラベルの外観を制御します
foregroundStyleモディファイアはメインテキストの色を変更します
アクションラベルにはアプリの色遣いが使用されます
最後にボタン固有のモディファイアをいくつか紹介します一致する連絡先が1つだけの場合はその連絡先の情報の一部をボタンに表示できますこれはcontactAccessButtonCaption モディファイアで指定できます
contactAccessButtonStyleモディファイアを使用すると連絡先の写真サイズをカスタマイズできます
連絡先ボタンはアプリが堅牢なプライバシー保護のもとで追加のアクセス許可を得るための強力かつ便利な方法ですボタンにはアプリがアクセスを許可される前は機密情報が表示されているためその内容は非公開にされていますがボタン自体はアプリに表示されます
さらにボタンは検証済みのイベントにのみ反応します
最後にボタンがタップされた時にアクセスが許可されるのはその内容がはっきりと読み取り可能で隠されていない場合のみですそのためボタンをタップすると何が起こるのかは常に明確です
ボタンは判読可能でなければならず隠されていてはなりませんそうでないと追加の連絡先へのアクセスがアプリに許可されません
まず最初に前面要素と背景のコントラストが高くレンダリングに十分なスペースがありボタン全体が表示されるように構成されたボタンの例を示しますこれはボタンの可読性に関するすべての要件を満たしていますその下は不適切に設定されたボタンの例ですテキストと背景のコントラスト比が非常に低く白い背景に薄いグレーの文字を使用しています
またボタンの一部が切り取られて見えなくなっています
このボタンをタップしても連絡先へのアクセスは許可されません
連絡先アクセスボタンは判読可能で隠されておらずレンダリングに十分なスペースがあることを常に確認してください
Contactsフレームワークにはこのボタンの他に連絡先データにアクセスする方法が3つありますそれぞれの仕組みと限定アクセスを使用する意味について説明します
CNContactStoreは連絡先データにアクセスするための主要な方法ですこれを使用すると連絡先を取得して新しい連絡先エントリを作成できます
アプリが連絡先データにアクセスしようとすると CNContactStoreは自動的に許可プロンプトを表示します
CNContactStoreを使用してアプリの現在の許可レベルを確認しそのレベルに応じて適切なUIを表示してください
連絡先データの読み書きが成功するのはアプリがアクセスを許可されている場合のみです
CNContactStoreは連絡先データが変更されると通知もするほかその変更内容の確認にも使用できます
アクセスが制限されている場合連絡先ストアはアプリと共有されている連絡先エントリを提供します許可状態が新しい .limited列挙型ケースかどうかを調べることでフルアクセスと部分的なアクセスのどちらが許可されたかを判断できます .limitedステータスはどのUIを表示するかを決定するために用意されていますこれは ContactAccessButtonのような限定的な許可のために設計された新しい連絡先APIを選択的に使用する場合に便利です
最後に CNContactStoreは ContactAccessButtonを使用するために不可欠な部分であり連絡先IDの配列を返します CNContactStoreでこれらのIDを使用すると必要な連絡先データを取得できますどのように動作するのか例を示します
これは連絡先ID文字列の配列を受け取り各IDが表すCNContactsを返す関数ですメインアクターがブロックされるのを避けるため待機しているタスク内でフェッチ処理を実行します
このタスク内でまずCNContactFetchRequestを作成しフェッチしたい連絡先フィールドのキーをリストアップしますこの例では連絡先名を表示するために必要なフィールドのみを取得します
ここではIDに基づいて連絡先を取得するために CNContact.predicateForContacts (withIdentifiers:)を使用します
その後 CNContactStoreの enumerateContacts(with:)を使用して収集した結果を配列に格納します連絡先データにアクセスするもう一つの方法は CNContactPickerViewControllerの使用ですこのビューコントローラは連絡先データベースから 1つ以上の連絡先を選択するためのシステムUIを表示します
連絡先が選択されると選択された連絡先のスナップショットがアプリに1回だけ送られますこのビューコントローラはアプリの許可レベルに関係なく動作し常に連絡先データベース全体を表示します
ピッカーで1つ以上の連絡先が選択されるとユーザーとのやり取りの中で暗黙の許可が与えられアプリは連絡先データを受け取ります
CNContactPickerViewControllerは連絡先情報が単発のタスクに必要なだけの場合に最適です例えば Eメールアドレスや電話番号を選択するなど連絡先が1回限りアプリに共有される場合です
iOS 18には新しいピッカー contactAccessPickerがありますこれによって表示されるモーダルシートではアプリがアクセスを制限されている連絡先セットを変更できますこれは一括操作や即時性のないユースケースで追加の連絡先にアクセスする場合に使用します例えばソーシャルアプリでは友達をマッチングさせる目的で追加の連絡先を共有する機能が必要になる場合があります
contactAccessPickerは新たにアクセスを許可された連絡先のIDを返します
CNContactPickerViewControllerと異なる点はここです contactAccessPickerはアプリがアクセス可能な連絡先を CNContactStoreを介して管理するための機能です CNContactPickerViewControllerは連絡先データの 1回限りのスナップショットへのアクセスを提供します
その使い方の例を紹介しますこの例では Stateブール値を切り替える単純なボタンを使用しますここで contactAccessPickerメソッドを使用してブール値がtrueの場合はボタンにピッカーを表示させます
最後にコールバックブロックでアプリにアクセスが許可されたばかりの連絡先を取得します
ContactAccessButtonと同様このコールバックブロックは連絡先ID文字列の配列を受け取るので連絡先の取得方法はまったく同じですただしこの方法では新たにアクセス可能となった連絡先だけが報告されます私が説明したすべての例はこの動画に関連付けられたサンプルアプリで利用できます各APIの使用法を説明したコメントも確認できます
連絡先にアクセスする方法は4種類あり許可レベルによってそれぞれ影響が異なります使い分けをまとめてみましょう
CNContactPickerViewControllerはどの許可レベルでも動作し常にビューコントローラで選択された連絡先への 1回限りのアクセスを可能にします CNContactStoreは連絡先データへの主要なゲートウェイでありアクセス許可を必要としますまれにアプリの許可状態が「Full」である場合そのアプリはあらゆる連絡先データを読み書きできますアプリが限定的にアクセスを許可されている場合は許可された連絡先セットにしかアクセスできません
アプリの許可状態が「Not determined」の場合は CNContactStoreのクエリ時に許可プロンプトが表示されます
アプリがアクセスを拒否された場合連絡先データにはアクセスできません ContactAccessButtonはアプリが限定的にアクセスを許可されている時に追加の連絡先にアクセスするための機能ですタップすると CNContactStoreを使用して連絡先が取得されますこのボタンはアプリが許可を受ける前に使用することもできます UIとして ContactAccessButtonを使用するとアプリが限定的にアクセスを許可されている場合でも最適な体験が得られます
contactAccessPickerはアプリの限定的アクセスを管理する機能なので限定アクセスを許可されている場合にのみ使用してください
これで連絡先の許可レベルとアクセス方法がすべてわかったことになります
次のステップとして iOS18でアプリを実行しアクセスを制限して動作をテストします ContactAccessButtonを使用すると必要な時にすぐにアプリのUIから連絡先へのアクセスを直接管理できます
連絡先情報を共有するためにアプリにとってどの連絡先アクセス方法が最適かを検討してください
ご視聴ありがとうございました

// Using ContactAccessButton

@Binding var searchText: String
@State var authorizationStatus: CNAuthorizationStatus = .notDetermined

var body: some View {
    List {
        ForEach(searchResults(for: searchText)) { person in
            ResultRow(person)
        }
        if authorizationStatus == .limited || authorizationStatus == .notDetermined {
            ContactAccessButton(queryString: searchText) { identifiers in
                let contacts = await fetchContacts(withIdentifiers: identifiers)
                dismissSearch(withResult: contacts)
            }
        }
    }
}

6:10 - Appearance options

ContactAccessButton(queryString: searchText)
  .font(.system(weight: .bold))
  .foregroundStyle(.gray)
  .tint(.green)
  .contactAccessButtonCaption(.phone)
  .contactAccessButtonStyle(ContactAccessButton.Style(imageWidth: 30))

10:11 - Fetching contacts with CNContactStore

// Fetching contacts with CNContactStore

func fetchContacts(withIdentifiers identifiers: [String]) async -> [CNContact] {
    return await Task {
        let keys = [CNContactFormatter.descriptorForRequiredKeys(for: .fullName)]
        let fetchRequest = CNContactFetchRequest(keysToFetch: keys)
        fetchRequest.predicate = CNContact.predicateForContacts(withIdentifiers: identifiers)
        var contacts: [CNContact] = []
        do {
            try CNContactStore().enumerateContacts(with: fetchRequest) { contact, _ in
                contacts.append(contact)
            }
        } catch {
            // ...
        }
        return contacts
    }.value
}

12:47 - Using contactAccessPicker

// Using contactAccessPicker

@State private var isPresented = false

var body: some View {
    Button("Show picker") {
        isPresented.toggle()
    }.contactAccessPicker(isPresented: $isPresented) { identifiers in
        let contacts = await fetchContacts(withIdentifiers: identifiers)
        // use the new contacts!
    }
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

関連する章

リソース