위젯 및 연령 확인을 위한 모바일 통합 안내
모바일에서 k-ID를 가장 잘 통합하는 방법을 명확히 하기 위해 문서를 업데이트했습니다: 연령 게이트와 동의 단계에는 네이티브로 구축한 UX가 플레이어에게 가장 원활한 경험을 제공하며, 연령 확인 및 연령 보증 URL과 같은 웹 임베드는 시스템 브라우저 구성요소를 통해 표시됩니다.
새로운 기능
연령 게이트 및 End-to-End 위젯에 대한 모바일 안내
연령 게이트 및 end-to-end 위젯은 모바일에서 완전히 지원됩니다. 연령 게이트와 동의 단계의 경우, 가장 브랜드에 통합된 경험을 위해 사용자 정의 워크플로를 사용하고 CDK UX 가이드라인에 따라 UX를 네이티브로 구축하는 것을 권장합니다.
k-ID API가 반환하는 연령 확인 및 연령 보증 URL도 동일한 방식으로 표시됩니다. 특정 엔드포인트와 챌린지 유형은 모바일 앱 가이드를 참조하세요.
개편된 모바일 앱 가이드
모바일 앱 가이드는 모바일에서 가장 일반적인 웹 임베드인 연령 확인을 중심으로 재구성되었습니다:
- 모든 예제(서버 요청, 클라이언트 가져오기, 표시 및 콜백 처리)가 이제
/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 임베디드 흐름: end-to-end 및 연령 게이트 위젯에 대한 모바일 표시 안내 추가
- CDK 개요: 통합 접근 방식 비교에 모바일 안내 추가
- CDK 사용자 정의 워크플로: 사용자 정의 워크플로를 모바일 앱에 권장되는 접근 방식으로 명시
- Verifiable Parental Consent (VPC): 이 위젯 기반 가이드에 모바일 사용에 대한 참고 사항 추가
다음 단계
- 모바일에서 통합하는 경우 가장 원활한 경험을 위해 사용자 정의 워크플로와 CDK UX 가이드라인을 사용하여 연령 게이트와 동의 UX를 네이티브로 구축하는 것을 고려하세요
- 확인 URL을 표시할 때 가로 고정 앱에는 기본 브라우저 방법을 사용하세요