ウォレットとApple Payの新機能

ウォレットとApple Payの新機能

ウォレットとApple Payの最新アップデートを紹介します。事前承認済みの支払い、資金移動、Apple Pay Laterマーチャンダイジングを活用して、アプリまたはWebで優れたApple Payのユーザー体験を作成する方法を紹介します。ウォレットの注文の追跡では、メール、メッセージ、Safari、サードパーティアプリのサポートが改善され、注文のトランザクションや領収書の詳細に情報を追加できるようになりました。また、追加のハードウェアを必要とせず、iPhoneを使用してウォレットでIDを確認し認証できる、新しい「Tap to Present ID on iPhone」についても紹介します。

リソース
関連ビデオ

Tech Talks
- Apple Payと注文管理の実装
WWDC22
- ウォレットとApple Payの最新情報
ダウンロード

♪ ♪
「ウォレットとApple Payの新機能」へようこそ私はDavidですそしてJonです今日はウォレットとApple Payの体験に今年導入されるすべての新機能と機能強化について説明しますウォレットとApple Payには幅広い機能が含まれていますバーコードパスや交通カードそして車のキーなどですこれらはすべてエコシステムの重要な部分ですが今日は次の3つの領域に焦点を当てますそれは支払い注文の追跡本人確認ですまずは支払いから始めましょう
まず Apple Pay Laterとそのマーチャンダイジングサポートをプラットフォーム内に統合する方法について説明します事前承認済みの支払いのいくつかの機能強化について説明しその後 Apple Payを使用した― 資金移動をサポートするための新しいAPIについて説明します Apple Pay Laterは今年初めに米国で導入されユーザーは買い物を4回に分けて支払うことができますユーザーはウォレット内でこれらの購入を簡単に追跡および管理できます Apple Pay Laterは統合を必要としませんが UI内に含めるための専用のマーチャンダイジングビューを新しいAPIを導入していますこのビューを使用すると Apple Pay Laterのサポートが示されユーザーへの詳細情報が示されますビューのスタイルを表示されるコンテキストに合わせてカスタマイズできるようになりますユーザーが詳細を確認するためにこのビューを選択すると Apple Pay Laterの説明方法を選択できますこのビューはアプリとWebの両方のデベロッパが利用できるようになります
マーチャンダイジングビューはコンテキストに応じて4つの異なる― 表示スタイルでレンダリングできます
標準スタイルでは Apple Pay Laterを使用して購入を複数回に分割する方法を簡単に説明しますバッジスタイルはサポートを簡潔に示しますチェックアウトスタイルはチェックアウトフロー内で他の支払いオプションと並べて配置できるようにデザインされていますそして購入総額と合わせて使用する価格スタイルですユーザーがこのビューを操作すると詳細情報が表示されますマーチャントは2つの異なるアクションから選択することができます「Learn More」アクションでは Apple Pay Laterの概要が表示され Apple Pay Laterを支払い方法として選択した場合にユーザーが経験するエクスペリエンスが説明されます「Calculator」アクションでは引き続き Apple Pay Laterの説明が表示されますがユーザーが従う必要がある返済スケジュールに重点が置かれていますこのビューをアプリ内に組み込む方法を見てみましょう
まずユーザーが Apple Pay Laterを使用する資格があるかどうかを確認しますこれを行うには PKPayLaterUtilities内の validate関数を使用できますトランザクションの金額と必要なロケールを指定する必要がありますユーザーが Apple Pay Laterを使用する― 資格があるかどうかを判断したら資格チェックで提供されたのと同じ詳細を使用して PKPayLaterViewをインスタンス化しますビューのスタイルとアクションをカスタマイズしたい場合はそれぞれのプロパティを変更することで実行できますまた SwiftUIアプリ内で Apple Pay Laterの受け入れを表現できる便利なSwiftUIビューも提供しますこれを使用するにはPayLaterViewをインスタンス化し以前と同じ情報を提供します表示スタイルとアクションをカスタマイズするには適切なビューモディファイアを使用しますこのようにとても簡単です Web上でマーチャンダイジングビューをサポートしたい場合は最初にいくつかの設定手順を実行する必要があります
ビューを表示するためのAPIは既存のApple Pay JavaScript SDK内で提供されますがこれを含めるときに設定する必要がある― 新しい属性がいくつかあります Cross Origin Resource― 共有リクエストをサポートする必要がある場合は crossorigin属性を設定することが重要です async属性を使用するとページの読み込みの進行状況とは関係なくスクリプトが確実に読み込まれ実行されます最後に APIへのリクエストを認証するには JWTが必要ですこのトークンは Apple Developerポータルで生成できます JavaScript SDKの使用はこのようにいたって簡単です apple-pay-merchandising 要素を使用してビューを表します金額国コード通貨コードおよびロケールは必須のフィールドですネイティブAPIと同様に必要に応じてビューの他の側面をカスタマイズすることもできます Apple Pay Laterのマーチャンダイジングビューを組み込む場合に従うべきベストプラクティスをいくつか紹介しますアプリの場合このビューを使用するにはエンタイトルメントが必要ですこれは Apple Developer ポータルで入手できます Webサイトの場合は SDKを含めるときに使用するードメインを登録し JWTを取得することを忘れないでくださいこれは Apple Developer ポータルでも実行できます可能であれば head要素内に SDKをインポートするようにしてくださいこれによりできるだけ早く実行できるようになりページが完全に読み込まれたときにマーチャンダイジングビューが整いますビューのサイズはニーズに合わせてカスタマイズできますが必ずサイズ要件に従ってください最後に Webサイトに制限的なコンテンツセキュリティポリシーが適用されている場合推奨されるガイドラインに従って SDKをドメイン間で確実に読み込めるようにしてください以上がApple Pay Laterの概要です次は事前承認済みのについて説明します iOS 16では事前承認済みの支払いが導入されましたユーザーは事前に承認した支払いをウォレットで確認・管理することができマーチャントは合意された条件に従ってユーザーに請求することができます定期支払いと自動補充支払いのサポートは当初から提供されていますが今回後払いにも対応しました事前承認済みの3つの支払いタイプはすべて― Webだけでなくアプリでも使用できます後払いでは将来の特定の日に固定金額または変動金額を請求できます無料キャンセル締切日がある場合はこれもリクエストの一部として指定できます後払いが適している例としてはユーザーがホテルを予約する場合や商品を予約注文する場合などがあります
事前承認済みの支払いはApple Payのマーチャントトークンを利用します
これらは個々のデバイスではなくユーザーの Apple IDに紐付けられていますこれはたとえばユーザーがデバイスをアップグレードした場合でもトークンは引き続き使用できることを意味しますこのため引き続きトークンを使用して口座に請求できるため― 後日の支払いの受け取りがより確実になります事前承認済みの支払いを実行するときカスタマーの支払いカードがマーチャントトークンに対応している場合マーチャントトークンが自動的に発行されます支払いカードがマーチャントトークンをサポートしていない場合でもトランザクションは続行されますが個々のデバイスに関連付けられている従来のApple Payトークンが使用されます Apple Payマーチャントトークンの詳細については昨年の「What's new in Wallet and Apple Pay」をご覧くださいそれではアプリ内に後払いを組み込む方法を見てみましょうまず PKDeferredPayment summaryItemを作成しますこれは料金と請求される金額の説明の概要を示しますまた支払いが行われる日付も設定します次に PKDeferredPaymentRequest を作成します先ほど作成した概要項目と支払いの管理に関するその他の情報を提供しますユーザーに表示する必要がある支払い同意がある場合これを後払いリクエストに設定することもできますリクエストを作成して設定したら PKPaymentRequestに添付できますリクエストに応じた支払い概要項目については以前と同じ金額と日付で別のPKDeferred PaymentSummaryItemを作成しますただし今回はマーチャントの名前を表すラベルが付いていますリクエストに応じてこれを設定したので支払いのために提示する準備が整いました
この例に見られるように Apple Payペイメントシートは支払い同意に関する情報といつ請求されるかについての情報とともに後払いをユーザーに提示します無料キャンセル日を指定する場合は考慮すべき重要な点がいくつかあります
無料キャンセル日を指定するとその時点より前のキャンセルはユーザーに無料で行われることを表明することになりますこのため日付と時刻の両方が重要な情報となりますキャンセルポリシーが適用されるタイムゾーンを明示する必要がありますこれをサポートするために別のプロパティを提供しました以下の例ではタイムゾーンが太平洋標準時であると指定していますカスタマーのタイムゾーンがキャンセルポリシーのタイムゾーンと一致しない可能性があるためこれは重要ですたとえば英国に拠点を置いている人が米国のホテルを予約するとします後払いを使用する場合は次のベストプラクティスに従ってください
前述したように無料キャンセルポリシーを説明する必要がある場合は後払いリクエストに指定する日付時刻タイムゾーンを慎重に検討してください概要項目に後払いを必ず含め適切なマーチャント名を設定してくださいこれは自動的に行われないためご注意ください支払い同意のテキストを提供するときは必ず短くしてください支払い同意のテキストは考慮すべき重要な事実の概要としてのみ機能するものであり― 通常の請求契約や法的契約に代わるものであってはなりません最後にトークン通知URLを指定しますこれにより Apple Pay― マーチャントトークンが発行された場合そのライフサイクルイベントの最新情報を受け取ることができます以上が後払いについてでした次に Apple Payを使用したまったく新しい資金移動の方法を見てみましょう従来のApple Payではユーザーが口座に資金を追加するために常にペイメントシートを利用できました iOS 17の新機能「Transfer Funds with Apple Pay」についてご紹介します
これによりユーザーは口座からウォレット内のカードに送金できるようになり送金のライフサイクルが完了しますこれは支払いと同じ安全でプライベートな Apple Payインフラストラクチャを使用するためユーザーにはすでに馴染みのあるプロセスになります資金移動を利用可能にするシナリオとしてユーザーが銀行口座またはその他の口座から資金を引き出きだせるようにする場合が考えられます Transfer Funds with Apple Payをサポートするために資金移動に必要な情報のみに焦点を当てた新しいリクエストタイプを作りましたこれを使用するにはユーザーの支払いカードに移動したい金額を定義するだけです受取人の連絡先詳細が必要な場合はこれらをリクエストすることもできます以前に PKPaymentRequestを使用したことがある場合はこの新しいAPIはとても身近に感じられるでしょう Apple Payを使用した資金移動は支払いと同じインフラストラクチャで機能するため Apple Developerポータル内でマーチャントとして登録する必要がありますマーチャントとして登録し Apple Payを使用するための設定方法の詳細についてはTech Talk 「Implement Apple Pay and order management」をご覧ください Apple Payを使用した資金移動の仕組みを説明するために例を見てみましょう Andrewというユーザーがいて口座からお金を引き出したいとします Apple PayでのTransfer Fundsを使えばアプリ内から送金がトリガーされます次にアプリはリクエストを作成し送金する金額の概要を示します次にAndrewには送金の詳細を記載した― Apple Payシートが提示され送金の受け取り先のカードを選択できるようになります Andrewが送金を安全に認証すると暗号化されたペイロードが生成されてアプリに返され支払いプロバイダによる処理の準備が整います送金が処理されるとアプリはApple Payに結果を返します送金成功すればそれで終わりですエラーが発生した場合は Andrewに通知され問題を解決するための修正措置を講じることができます資金移動の仕組みの概要を理解したところでアプリ内で実装する方法を見てみましょうまずどのネットワークとカードの機能をサポートするかを決定する必要があります次にユーザーが Transfer Fundsに対応したカードを持っているかどうかを確認しますこれは PKPaymentAuthorization Controllerを通じて行われます supportDisbursements メソッドを使用して前に定義したネットワークとカードの機能を確認します対応状況の確認後必要に応じてユーザーインターフェイスを調整します利用資格を確認したので資金移動リクエストの作成を開始できます支払請求と同様に金額は概要項目によって定義されますこの場合 2つの異なる概要項目を作成します 1つ目は PKPaymentsummaryItemですこれはユーザーの口座から引き出される金額を表します重要なのはアイテムに付随するラベルはあなたのビジネス名である必要があります 2番目の項目は新しいタイプの概要項目である― PKDisbursementSummaryItemですこれらのいずれかを含める必要があり受取人の支払いカードに手数料や料金または調整額を差し引いた最終金額を表す必要があります支払いには PKPaymentRequestがありますが Transfer Funds with Apple Payには PKDisbursementRequestという新しいリクエストタイプがあります PKDisbursementRequestを構築するには特定の詳細を指定する必要がありますこれには Apple Payに登録するときに設定したマーチャントIDや取引通貨― ビジネスの地域および以前に定義した― ネットワークと機能が必要です先に作成した概要項目も指定します送金先の連絡先詳細が必要な場合はここでリクエストすることもできます受取人の支払いカードが発行された地域を制限することもできますリクエストが構築されたらそれをユーザーに提示できますこれを行うには支払いリクエストで PKPaymentAuthorizationController のインスタンスを初期化しますここでは私たち自身を代理人として設定・提示しますここでわかるようにユーザーには送金先の支払いカードとそのカードに受け取る金額を選択する― オプションが表示されますユーザーが送金の実行を安全に承認したら送金を処理するためにいくつかのデリゲートコールバックを実装する必要があります Transfer Funds with Apple Payを処理するために実装する必要があるデリゲートメソッドは2つだけです 1つ目はpaymentAuthorization ControllerDidFinishですこれはシートを閉じる準備ができたときに呼び出されますそれを閉じる責任は呼び出し元のアプリにありますこのメソッドを使用して独自のアプリのUIを適宜変更することもできます 2番目は didAuthorizePayment デリゲートメソッドです Transfer Funds with Apple Payは支払いと同じインフラストラクチャを使用し処理に使用する同じタイプの PKPaymentオブジェクトを受け取りますここではトークンの処理を独自の processFundsTransferメソッドに抽象化しました処理の結果に応じて成功または失敗のいずれかを返します
処理段階でエラーが発生した場合それらを表す便利なメソッドのセットが提供されています取得された連絡先情報に関連する― 問題がある場合は disbursementContactInvalidError を使用できますユーザーの支払いカードが資金移動を受け付けられないと決済処理業者が判断した場合は disbursementCardUnsupportedErrorを使用できます一部の金融機関は即時送金をサポートしており受取人に資金をより迅速に送金できますこれらは Transfer Funds with Apple Payでも可能ですサービスによってはこれらの即時送金に手数料が含まれる場合がありそれを示すこともできます通常ユーザーはアプリ内で資金移動のスピードを選択できますユーザーが資金の即時移動を選択した場合― ユーザーに対するサポートを要求する機能を提供しますその場合、ユーザーが選択できるカードは即時送金をサポートすることがわかっているカードに限定されます
即時送金は次のようになります
シートは以前と非常によく似ていますが今回は送金が即時に行われるという事実とユーザーが支払う料金を強調しています振込金額も手数料を考慮して調整されております前回の転送リクエストを即時リクエストにする方法を見てみましょうまずサポートされている機能のリストに InstantFundsOutを追加します次に supportsDisbursements 内でユーザーが即時送金をサポートするカードを持っているかどうかを確認できますその後適切に送金方法のオプションとユーザーインターフェイスを調整できます概要項目に関しては即時送金手数料を表すPKInstantFundsOut FeeSummaryItemがありますこの項目では即時送金に必要な手数料を指定します手数料を請求しない場合でもこの概要項目は必須ですその場合金額をゼロに設定しますこの例では手数料を請求しているためそれに応じて支払い金額を更新する必要がありますこれは自動的には行われません PKDisbursementRequestの作成は以前とあまり変わりません唯一の違いは前に定義した機能と概要項目を確実に提供することです即時送金を表すために必要なのはこれだけです Transfer Funds with Apple Payを実装する際に留意すべきベストプラクティスをいくつか紹介します
Transfer Funds with Apple Payは iOSおよびiPadOSでのみ利用可能であり macOSまたはWebでは使用できないことに注意してください資金移動の処理中にエラーが発生した場合はこれをユーザーに効果的に伝えるために専用の支払いエラーの1つを使用します最初の概要項目はユーザーの口座から引き落とされる金額を表すべきであることに注意が重要です最初の概要項目のラベルはあなたのビジネスのラベルと一致する必要がありますそして最後の概要項目はユーザーの支払いカードで受け取られる手数料や料金または調整を差し引いた金額を表す必要があります支払いに関しては以上です少し軌道を変えて注文の追跡について話しましょう注文の追跡はユーザーが参加マーチャントへの注文を追跡する方法としてiOS 16で導入されましたユーザーからの反響は素晴らしく私たちは注文の追跡をさらに改善するために真摯に取り組んできました注文をより適切に表示・伝達するためにオペレーティングシステム内の統合をどのように改善したかについて説明します次に注文の追跡に加えられたいくつかの機能強化について説明しますそして最後にウォレットに注文を追加する新しい方法を導入します iOS 16.4ではメッセージを介した注文の共有のサポートが追加され注文のインラインプレビューが提供され受信者がウォレット内で注文を追跡できるようになりましたまたユーザーが一目で注文を追跡できる― 注文の追跡ウィジェットも導入しましたユーザーは追加の作業を必要とせずにすでにこれらの新機能の恩恵を受けることができます iOS 17ではマップのサポートによるシステム統合を継続していますユーザーが受け取り時間と受け取り場所を指定した注文を追跡している場合マップは Siriの提案を通じて積極的にそれを提案します次にiOS 17の注文の追跡に加えられた― 機能強化の一部を見てみましょう宅配便や食品配達のユースケースをより適切にサポートするために使用される配送の種類を指定できるようになりました新しいShippingType プロパティを使用して注文が出荷中か配達中かを宣言できます
エンタープライズアプリを含む関連アプリケーションのサポートが強化されました関連するアプリIDを宣言することでアプリと注文の追跡の間の管理を改善できますさらにカスタムプロダクトページIDをサポートしてウォレットトラフィックに最も関連性の高い App Storeプロダクトページへのディープリンクを可能にします最後に支払い情報を表現する新しい方法を導入しています注文パッケージはそれに関連付けられた一連のトランザクションをサポートするようになりそれぞれに支払い方法や金額などの独自の詳細情報が含まれますトランザクションに領収書ファイルを添付することもできるのでカスタマーは支払いの記録を得られます領収書ファイルはPDFまたはJPEGや PNGなどの画像のいずれかにできます注文パッケージのサイズには制限があることに注意してくださいそのため含める領収書ファイルのサイズを考慮してくださいトランザクションが購入なのか返金なのかを説明できるようになりました iOS 17ではウォレットへの注文の追加がこれまでになく簡単になりました注文確認メールなどのメールに注文パッケージを添付できるようになりましたユーザーはその場で注文をウォレットに追加できるようになりますさらにアプリやWebサイト内に「Track with Apple Wallet」ボタンを追加することもできますウォレットへの注文の追加をサポートする新しい注文の追跡APIを見てみましょうこれは2つの新フレームワークFinanceKitと FinanceKitUIに含まれていますこれら2つの Swift専用フレームワークによりデベロッパはウォレット内で注文データを処理できるようになります注文情報へのアクセスはFinanceStore の共有インスタンスを通じて実現され注文の追跡クエリを処理するための中心的なリソースを提供しますこのAPIを使用すると注文の有無を確認したり注文を追加または更新したりすることができます既存の注文を確認する方法を見てみましょうまず FinanceStoreにクエリして完全に資格を満たす注文IDを持つ注文が含まれているかを確認しますその後存在するか見つからないかのどちらかの回答が返ってきますその後必要に応じてアプリで応答できますそれはとても簡単です注文を追加または更新したい場合は 2つの方法のいずれかで実行できますまず FinanceKitを使用してこれを行う方法を説明しますまずウォレットに追加する署名付き注文パッケージのデータをシリアル化する必要があります次にこれをFinanceStoreの注文保存メソッドに提供しますこれを行うと注文の内容と注文をウォレット内で追跡するかどうかの確認画面がユーザーに表示されますユーザーがリクエストを確認または拒否すると結果は非同期で受信され 3つの形式のいずれかになります注文をウォレットに追加したかリクエストをキャンセルしたかまたは新しい注文がすでに存在しますアプリがSwiftUIで作成されている場合は FinanceKitUIを使用できますこれにより専用の「Track with Apple Wallet」ボタンが表示され注文の追加結果を処理できるようになります FinanceKitと同様に署名された注文パッケージのシリアル化されたインスタンスが最初に必要になります次にAddOrderToWalletButtonをビュー内に含めますユーザーがこのボタンを選択すると注文をウォレットに追加する機能が提供されますその後以前と同様に3つの結果の状態に応答できるようになります Web上でカスタマーの注文の追跡をサポートしたいマーチャント向けに JavaScript SDKでこのボタンのバージョンを提供していますこれを使用するには apple-wallet-buttonを挿入し属性を使用して設定しますボタンのタイプはtrack-orderに設定する必要がありますこのボタンを使用するときは追加する署名付き注文パッケージの場所を指すようにonClickコールバックを設定することが重要です以上が今日注文の追跡についてご紹介する内容ですこれらの新しいAPIをアプリやサービスに採用いただければ幸いですさてまったく別の話になりますが本人確認に関して共有したいいくつかのエキサイティングな最新情報がありますそれについてはJonに引き継ぎますありがとうDavid あらためて皆さんこんにちは私はエンジニアのJonです Apple Payとウォレットチームの一員です iOS 17の本人確認に追加された新機能についてお話しできて光栄です iOS 15.4でウォレットにIDが導入されサポートされている― 米国の州のユーザーが運転免許証または州IDをウォレットに追加できるようになりました昨年私たちは Verify with Walletを導入しましたこのAPIを使用するとビジネスは Appleウォレットに保存されているユーザーのIDから情報を要求することでオンボーディングとアカウント検証のフローを合理化できます今年のiOS 17ではiPhoneにタップして IDを提示する機能が導入されます
このAPIを使用するとアプリは iPhoneだけを使用してウォレットやその他のモバイル運転免許証の IDをシームレスかつ安全に検証できますこれはiOS 15.4でProximityReader フレームワークに追加された iPhone APIのTap to Payの上に構築されています iPhoneのTap to Payは追加のハードウェアや支払い端末を必要とせずに非接触型支払いを受け入れる－安全でプライベートな簡単な方法を提供しますでは Tap to Present IDの動作を見てみましょう私がSpaceship Rentalsで働いており Davidが当社から宇宙船をレンタルしたいと考えているとしますこれを行うには彼は21歳以上である必要があるので Tap to Present IDを使用して年齢確認を実行しますまず Spaceship Rentalsアプリが「Tap to Present ID」を呼び出します
私のiPhoneにはビジネスの名前やロゴおよび実行されているリクエストの種類― (この場合は年齢証明)が表示されますここでDavidにiPhoneを私の近くに持ってもらいます [iPhoneのチャイム音］ [iPhoneのチャイム音］私のiPhoneには同意書が表示され確認することができます Spaceship Rentalsに本人確認書を提示していることがわかり私が21歳以上であるかどうかの確認を要求していますこの情報を提示したいと思いますのでダブルクリックして Face IDで確認します私のiPhoneには Davidが提示した情報が表示されています彼は証明写真と一致しており 21歳以上であることがわかりましたこれで彼は離陸の準備ができました
Tap to Present ID APIを使用して DavidのIDを正常に検証できましたこの機能は物理的なIDを確認する場合と比較していくつかの重要な利点がありました
まず ID情報自体の検証が行われます改ざんされやすい物理的なIDとは異なりモバイル運転免許証は発行機関によって暗号化署名されており iOSがその署名を検証するため応答を信頼できます次にワイヤレスで安全な体験ができました DavidがiPhoneを私に手渡す必要はなくロックを解除する― 必要さえありませんでしたデータはNFC とBluetoothを使用して安全に送信されました最後にこれはIDを確認するためのよりプライベートな方法です Davidはすべてが共有される物理的なIDとは異なり年齢を確認するために必要な情報のみを共有する必要がありましたこのAPIで実行できるリクエストの種類について説明します表示リクエストのデモを行ったところです相手の名前や年齢を確認したい場合に適しています結果はシステムUIに表示され― ID情報はアプリに返されません APIはデータリクエストもサポートしていますこれらは住所生年月日― 運転権限などのより広範なドキュメント要素のセットをリクエストすることができ― 結果は処理するためにアプリに返されますデータリクエストを実行するにはアプリに追加のエンタイトルメントが必要です詳細についてはドキュメントを確認してください
ここで表示リクエストから始めてこれをコードで実装する方法を見てみましょう
まず MobileDocumentReaderの isSupportedクラスプロパティを使用して現在のデバイスがこのAPIをサポートしているかどうかを確認します存在する場合はリーダーオブジェクトをインスタンス化しそのprepareメソッドを呼び出しますこれにより MobileDocument ReaderSessionオブジェクトが返されます次に確認したい要素を表示するための運転免許証表示リクエストを作成しますここでは運転免許証の保有者が 21歳以上であるかどうかを確認しています次にセッションでrequestDocumentを呼び出しリクエストを渡します次にリーダーUIが表示され最初にID所有者にデバイスの提示を求め次に要求の結果を表示します
これは表示リクエストであるため requestDocumentメソッドからは何も返されないことに注意してくださいわずか数行のコードでモバイルドキュメントの読み取り機能をアプリに追加できますデフォルトではブランドの名前とロゴはリーダーのiPhoneにも ID所有者のデバイスにも表示されませんただしドキュメントのリクエスト時にブランド情報を表示したい場合は表示することができますこれは Apple Business Registerを通じてさらに数行のコードで設定できますドキュメントのリクエスト中にブランド情報を表示するにはデバイスの準備時にリーダートークンを渡す必要がありますこのトークンをサーバー上に作成する必要がありますリーダートークンはJWTであり Apple Business Registerを通じて設定したキーペアで署名されますサーバーはブランドID キーID リーダーインスタンスIDを使用してリーダートークンを作成しますブランドIDとキーIDは Apple Business Registerから取得でき― アプリのすべてのインスタンスで同じですアプリはリーダーインスタンスIDをサーバーに提供しますコードに戻るとアプリはMobileDocument Readerの設定オブジェクトからリーダーインスタンスIDを取得しリーダートークンと引き換えにそれをサーバーに送信しますこのトークンをprepareメソッドに渡してリーダーセッションを取得します次に前と同じようにリクエストを作成し requestDocumentを呼び出しますこれであなたのブランド名とロゴがリーダーのiPhoneとID所有者のデバイスの両方に表示されますこれで表示リクエストもカバーされますこれまでセッションを準備する方法ドキュメントをリクエストする方法― リーダートークンを使用してブランド情報を表示する方法について見てきました次にデータリクエストを実行する方法を見てみましょうこれらのリクエストはより広範囲のドキュメント要素をサポートし APIは結果を表示するだけでなくアプリに結果を返します
このリクエストタイプを使用するには以前と同様にまずデバイスにリーダートークンを準備する必要があります次に運転免許証データリクエストを作成しリクエストするドキュメント要素と情報を保持するかどうかを指定します
requestDocumentを呼び出すと表示リクエストと同様にリーダーUIが表示されますが読み取りが完了すると UIは自動的に閉じられますその後応答がアプリに返されて処理されますそれがiPhoneのTap to Present IDです ProximityReaderフレームワークに追加されたエキサイティングな新しいAPIですさて Davidの話に戻りましょう Jon ありがとう！さて今日私たちは何を学んだでしょうか？ Apple Pay Laterのサポートによる― 支払いの機能強化と新しいユースケースを検討してきました注文の追跡の新しいAPIを使用するとアプリやサービス内から注文をウォレットに追加できるようになり iPhoneで「Tap to Present ID」を使用してモバイル運転免許証を確認する新しい方法が追加されました最後に企業の方は Apple Business Registerへの登録をご検討くださいこれによりウォレットとApple Payでのユーザーエクスペリエンスを豊かにできます Appleデベロッパフォーラムにアクセスすると年間を通して質問したりサポートを受けることができます最後に皆さんのご意見をぜひお聞かせくださいフィードバックアシスタントから送信いただけます本日のセッションは以上ですお楽しみいただけたでしょうかご視聴ありがとうございます ♪ ♪

28:51 - Performing a display request to verify age

import ProximityReader

// Check the current device supports mobile document reading.
guard MobileDocumentReader.isSupported else { return }
    
let reader = MobileDocumentReader()
    
let readerSession: MobileDocumentReaderSession = try await reader.prepare()

let request = MobileDriversLicenseDisplayRequest(elements: [.ageAtLeast(21)])

try await readerSession.requestDocument(request)

30:55 - Displaying brand information during a document request

let reader = MobileDocumentReader()

let identifier = try await reader.configuration.readerInstanceIdentifier
let readerToken = try await WebService().fetchToken(for: identifier)

let readerSession = try await reader.prepare(using: .init(readerToken))

let request = MobileDriversLicenseDisplayRequest(elements: [.ageAtLeast(21)])

try await readerSession.requestDocument(request)

31:50 - Performing a data request

let session: MobileDocumentReaderSession = /* ... */

var request = MobileDriversLicenseDataRequest()
request.retainedElements = [.givenName, .familyName, .dateOfBirth, .portrait]
request.nonRetainedElements = [.address, .documentExpirationDate, .drivingPrivileges]

let response = try await session.requestDocument(request)

// Process document elements from document response.
self.processResponse(response.documentElements)

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

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

リソース

関連ビデオ

Tech Talks

WWDC22