깊은 링크를 통해 사용자를 경험의 특정 장소로 보낼 수 있으므로 사용자가 가입 과정을 더 원활하게 할 수 있고, 사용자가 친구를 찾을 수 있도록 도울 수 있습니다. 이 링크의 선택적 시작 데이터를 통해 사용자 경험을 사용자가 참여할 때 사용자 지정할 수 있습니다.
깊은 링크 생성
깊은 연결 링크 URL은 매개 변수를 지정한 URL 형식과 함께 구성됩니다. 다음 섹션에서는 각 형식을 구성하는 방법을 설명합니다.
요구 사항 및 가이드라인
깊은 링크를 구축할 때 다음 요건과 가이드라인을 고려하십시오.
- 특수 문자를 URL에 인코딩해야 합니다, 예를 들어 공백. 이 문자는 사용자가 경험에 참여할 때 자동으로 해독됩니다.
- 해독된 시작 데이터는 200바이트를 초과할 수 없습니다.
- 서버에서 HttpService:JSONDecode() 와 같은 복잡한 데이터를 JSON 문자열로 저장하고 해독할 수 있습니다.
- launchData 매개 변수에 민감한 정보를 보내지 마십시오; 그것은 웹에서 완전히 표시됩니다. 또한 사용자는 웹을 수정할 수 있으므로 데이터가 진위할 수 있습니다.
앱에 대한 웹 목록
이 형식은 사용자를 웹의 Roblox 경험 페이지로 보내고 다음으로 Roblox 앱을 시작합니다. 제공된 예시에서는 장소 ID와 URL 인코딩된 시작 데이터 문자열이 제공됩니다.
| 형식 | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| 예시 | 예시 링크 |
앱으로 직접
이 형식은 사용자를 Roblox 앱으로 직접 보냅니다. 제공된 예시에는 장소 ID 및 URL 인코딩된 시작 데이터 문자열이 포함되어 있습니다.
| 형식 | roblox://placeId=<id>&launchData=<string> |
| 예시 | 예시 링크 |
미룰
Roblox를 모바일 장치에 설치하지 않은 사용자는 앱스플라이어 버전의 심부 연결 사용자가 앱을 Roblox 앱을 다운로드하고 다음 심부 연결을 따라갈 수
| 형식 | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| 예시 | ro.blox.com/Ebh5?af_dp=roblox%3A%2F%2FplaceId%3D690030535 |
깊은 링크 처리
경험에서 Class.Player:GetJoinData() 메서드를 사용하여 시작 데이터를 수집하고, Class.Player:GetJoinData() 키에 있는 문자열을 사용자가 지정한 데이터 매개 변수의 launchData에 포함하여 링크 깊이의 연결반환합니다.
시작 데이터를 처리하는 방법에 대한 코드 샘플에 대한 Player:GetJoinData() 참조 문서를 참조하십시오.