깊은 링크

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

깊은 링크를 사용하면 사용자를 경험의 특정 장소로 보낼 수 있으므로 가입 과정을 더 원활하게 만들고, 사용자가 친구를 찾고 트래픽 공여를 제공할 수 있습니다.이러한 링크의 선택적 런칭 데이터로 사용자가 참여할 때 사용자 환경을 사용자 지정할 수 있습니다.

깊은 링크 연결

깊은 링크 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() 참조하십시오.