딥 링크
애플리케이션 및 이 기능을 지원하는 플랫폼 내 딥 링크를 활성화하는 방법에 대해 설명합니다.
읽는 시간 2분최근 업데이트: 10일 전
딥 링크는 사용자를 웹사이트가 아닌 애플리케이션 내 특정 위치로 안내하는 하이퍼링크입니다. 사용자가 딥 링크를 선택하면 Unity 애플리케이션의 특정 씬과 같이 지정된 위치에서 애플리케이션이 열립니다. Unity는 Application.absoluteURL 프로퍼티와 Application.deepLinkActivated 이벤트를 사용하여 딥 링크를 지원합니다.
딥 링크 활성화
딥 링크를 처리하기 전에 애플리케이션이 딥 링크에 반응하도록 설정해야 합니다. 특정 URL에 반응하도록 애플리케이션을 설정하는 프로세스는 플랫폼에 따라 다릅니다.
Unity 다음 플랫폼용 딥 링크를 지원합니다.
- iOS
- Android
- 유니버설 Windows 플랫폼
- macOS
- 웹 플랫폼(활성화 필요 없음)
딥 링크 사용
애플리케이션의 현재 상태에 따라 딥 링크를 처리하는 방법에는 두 가지가 있습니다.
- 애플리케이션이 실행 중이지 않습니다. 기기가 애플리케이션을 열고 Application.absoluteURL은 기기가 애플리케이션에 전달하는 딥 링크 URL을 저장합니다.
- 애플리케이션 실행 중: 디바이스가 URL을 애플리케이션에 전달하고 딥 링크 URL을 파라미터로 사용하여 Application.deepLinkActivated 이벤트를 호출합니다. Application.absoluteURL이 동시에 업데이트됩니다.
두 경우 모두 Application.absoluteURL을 사용하여 애플리케이션에서 열 씬을 선택합니다.
다음 코드 샘플은 애플리케이션의 현재 상태에 따라 딥 링크를 처리하는 방법을 보여 줍니다.
using UnityEngine;using UnityEngine.SceneManagement;public class ProcessDeepLinkMngr : MonoBehaviour{ public static ProcessDeepLinkMngr Instance { get; private set; } public string deeplinkURL; private void Awake() { if (Instance == null) { Instance = this; Application.deepLinkActivated += onDeepLinkActivated; if (!string.IsNullOrEmpty(Application.absoluteURL)) { // Cold start and Application.absoluteURL not null so process Deep Link. onDeepLinkActivated(Application.absoluteURL); } // Initialize DeepLink Manager global variable. else deeplinkURL = "[없음]"; DontDestroyOnLoad(gameObject); } else { Destroy(gameObject); } } private void onDeepLinkActivated(문자열 URL) { // Update DeepLink Manager global variable, so URL can be accessed from anywhere. deeplinkURL = url;// Decode the URL to determine action.// In this example, the application expects a link formatted like this:// unitydl://mylink?scene1 string sceneName = url.Split('?')[1]; bool validScene; switch (sceneName) { case "scene1": validScene = true; 중지; case "scene2": validScene = true; 중지; Default validScene = false; 중지; } if (validScene) SceneManager.LoadScene(sceneName); }}
딥 링크 테스트
딥 링크를 테스트하려면 다음 단계를 따르십시오.
- 테스트할 딥 링크가 포함된 HTML 파일을 만듭니다.
- 로컬 웹 서버에서 HTML 파일을 호스팅합니다.
- 기기의 웹 브라우저에서 HTML 파일을 열고 딥 링크를 클릭 수 있습니다.
HTML 파일 예시
딥 링크를 테스트하는 데 사용할 수 있는 예제 HTML 파일입니다. 링크를 리디렉션하려면 요소 중 하나의 속성을 변경합니다.
<a>href<html> <head> <meta charset="utf-8"> </head> <body > <h1>My Deep Link 테스트 페이지</h1> <p><a href="unitydl://mylink">Launch</a></p> <p><a href="unitydl://mylink?parameter">파라미터로 실행</a></p> </body></html>