깊은 링크를 사용하면 사용자를 경험의 특정 장소로 보낼 수 있으므로 가입 과정을 더 원활하게 만들고, 사용자가 친구를 찾고 트래픽 공여를 제공할 수 있습니다.이러한 링크의 선택적 런칭 데이터로 사용자가 참여할 때 사용자 환경을 사용자 지정할 수 있습니다.
깊은 링크 연결
깊은 링크 URL은 지정한 매개 변수와 함께 URL 형식으로 구성됩니다. 다음 섹션에서는 각 형식을 구성하는 방법을 설명합니다.
URL 매개 변수
깊은 링크는 다음 URL 매개 변수를 지원합니다. 그렇지 않은 경우를 제외하고 모두 선택 사항입니다.
매개 변수 | 설명 :--- | :--- placeId | 참여할 장소 ID.userId가 지정되지 않으면 필수입니다. Required unless is specified.userId | 참여할 사용자 ID.사용자가 경험을 떠났거나 오프라인 상태이면 "팔로우 사용자가 경험을 떠났습니다" 오류가 발생합니다.accessCode | 개인 서버 액세스 코드.linkCode | 개인 서버 링크 코드gameInstanceId | 참여할 게임 인스턴스의 고유 식별자, 또한 DataModel.JobId이라고 합니다.launchData | 깊은 연결포함하려는 프로모션 코드나 좌표와 같은 추가 정보Player:GetJoinData() 메서드를 사용하여 프로세스 수행.참조 발사 데이터 포함 .
요구 사항과 가이드라인
- 공백과 같은 특수 문자는 URL로 인코딩해야 합니다. 사용자가 경험에 참여하면 이러한 문자가 자동으로 디코딩됩니다.
- 디코딩된 런처 데이터는 200바이트를 초과할 수 없습니다.
- 더 복잡한 데이터를 JSON 문자열로 저장하고 서버에서 HttpService:JSONDecode()로 디코딩할 수 있습니다.
- launchData 매개 변수에 기밀 정보를 보내지 마십시오; URL에서 완전히 표시됩니다.또한 사용자는 URL을 수정할 수 있으므로 데이터가 진위하지 않을 수 있습니다.
웹 목록을 앱으로
이 형식은 사용자를 웹에서 Roblox 경험 페이지로 보내고 Roblox 앱을 시작합니다.제공된 예제에서는 장소 ID와 URL 인코딩된 런처 데이터 문자열을 제공합니다.
형식 | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
예시 | 예시 링크 |
앱으로 직접
이 형식은 사용자를 Roblox 앱으로 직접 보냅니다. 제공된 예제는 장소 ID와 URL 인코딩된 런칭 데이터 문자열을 제공합니다.
형식 | roblox://placeId=<id>&launchData=<string> |
예시 | 예시 링크 |
지연됨
모바일 장치에 Roblox가 설치되지 않은 사용자의 경우, 앱 플라이어 버전의 깊은 링크를 사용하여 사용자가 Roblox 앱을 다운로드하고 깊은 연결따르도록 합니다.이러한 유형의 깊은 연결생성하려면 https://ro.blox.com/Ebh5? 접두사를 지정하십시오.이전 섹션에서 설명한 "앱으로 직접" 깊은 링크와 "웹에서 앱으로" 깊은 링크(af_dp 매개변수)를 사용하여 "앱으로 직접" 깊은 링크와 "웹에서 앱으로" 깊은 링크(af_web_dp 매개변수)를 제공합니다.
형식 | 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%3D6900305353%26launchData%3D%257B%2522roomId%2522%253A%25202%257D&af_web_dp=https%3A%2F%2Fwww.roblox.com%2Fgames%2Fstart%3FplaceId%3D6900305353%26launchData%3D%257B%2522roomId%2522%253A%25202%257D |
깊은 링크 연결
경험에서 런처 데이터를 얻으려면 Player:GetJoinData() 메서드를 사용하여 사전을 반환하는 메서드를 가져옵니다.그 사전에서 LaunchData 키는 깊은 연결launchData 매개변수에서 지정한 문자열을 포함합니다.
실행 데이터를 처리하는 방법에 대한 코드 샘플의 참조 문서는 Player:GetJoinData() 참조하십시오.