위젯 및 연령 확인을 위한 모바일 통합 안내
모바일에서 k-ID를 통합하는 방법을 명확히 하기 위해 문서를 업데이트했습니다: 연령 게이트와 동의 흐름은 네이티브로 구축하고, 웹 임베드는 연령 확인 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만 임베드하고, 가로 고정 앱에는 기본 브라우저 방법을 사용하세요