ウィジェットと年齢確認に関するモバイル統合ガイダンス
モバイルでk-IDをどのように統合すべきかを明確にするため、ドキュメントを更新しました。年齢ゲートと同意フローはネイティブに構築し、Web埋め込みは年齢確認URLに限定してください。
新機能
年齢ゲートとエンドツーエンドウィジェットに関するモバイルガイダンス
年齢ゲートウィジェットとエンドツーエンドウィジェットは、モバイルアプリには推奨されません。モバイルでは、カスタムワークフローを使用し、CDK UXガイドラインに従って年齢ゲートと同意のUX要素をネイティブに構築してください。
モバイルでサポートされる唯一のWeb埋め込みは、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）: このウィジェットベースのガイドがWeb専用である旨の注記を追加
次のステップ
- モバイルで統合する場合は、カスタムワークフローとCDK UXガイドラインを使用して、年齢ゲートと同意のUXをネイティブに構築してください
- モバイルでは年齢確認URLのみを埋め込み、横向きロックされたアプリにはデフォルトブラウザ方法を使用してください