ウィジェットと年齢確認に関するモバイル統合ガイダンス
モバイルでk-IDをどのように統合するのが最適かを明確にするため、ドキュメントを更新しました。年齢ゲートと同意ステップについては、ネイティブに構築したUXがプレイヤーに最もシームレスなエクスペリエンスを提供し、年齢確認URLや年齢保証URLなどのWeb埋め込みはシステムブラウザサーフェスを通じて表示されます。
新機能
年齢ゲートとエンドツーエンドウィジェットに関するモバイルガイダンス
年齢ゲートウィジェットとエンドツーエンドウィジェットは、モバイルで完全にサポートされています。年齢ゲートと同意ステップについては、最もブランドに統合されたエクスペリエンスを実現するために、カスタムワークフローを使用し、CDK UXガイドラインに従ってUXをネイティブに構築することを推奨します。
k-ID APIから返される年齢確認URLと年齢保証URLも同じ方法で表示されます。具体的なエンドポイントとチャレンジタイプについては、モバイルアプリガイドを参照してください。
モバイルアプリガイドの刷新
モバイルアプリガイドは、モバイルで最も一般的なWeb埋め込みである年齢確認を中心に再構成されました：
- すべての例（サーバーリクエスト、クライアントの取得、表示、コールバック処理）で、
/age-verification/perform-access-age-verificationからの年齢確認URLを使用するようになりました - 結果処理では、
Verification.ResultDOMイベントと、/age-verification/get-statusによるサーバー側での確認を扱います
デフォルトブラウザ方法
モバイル実装方法として、デフォルトの外部ブラウザ方法が新たに文書化されました。これはAndroid（Intent.ACTION_VIEW）とiOS（UIApplication.open）の両方で機能し、AgeKeysを完全にサポートし、redirectUrlコールバックを通じてアプリにフォーカスを戻します。
デバイスの向きに関するガイダンス
年齢確認はポートレート（縦向き）で最も効果的に機能します。アプリ内ブラウザサーフェスはアプリの向きのロックを継承するため、横向きにロックされたアプリでは、確認URLをデフォルトの外部ブラウザで開いてください。ブラウザは独自の向きを管理するため、ユーザーはポートレートに回転でき、フロー完了時にはredirectUrlコールバックがアプリに戻します。
更新されたドキュメント
- モバイルアプリ: 年齢確認を中心に再構成し、デフォルトブラウザとデバイスの向きのセクションを新設
- CDK 埋め込みフロー: エンドツーエンドウィジェットと年齢ゲートウィジェットのモバイルでの表示ガイダンスを追加
- CDK 概要: 統合アプローチの比較にモバイルガイダンスを追加
- CDK カスタムワークフロー: カスタムワークフローがモバイルアプリに推奨されるアプローチである旨を記載
- 検証可能な保護者の同意（VPC）: このウィジェットベースのガイドのモバイルでの利用に関する注記を追加
次のステップ
- モバイルで統合する場合は、最もシームレスなエクスペリエンスを実現するために、カスタムワークフローとCDK UXガイドラインを使用して、年齢ゲートと同意のUXをネイティブに構築することを検討してください
- 確認URLを表示する際、横向きロックされたアプリにはデフォルトブラウザ方法を使用してください