Unity 게임에 웹숍 통합

필수 조건

• 인앱 구매를 통합하는 Unity 프로젝트입니다.
• 프로젝트의 Authentication SDK(버전 3.7.1 이상)
• 타겟 환경의 웹숍입니다.

shop.unity.com/{studio}/game/{slug}

게임에서 웹숍 열기

SDK 헬퍼 사용

RedirectToWebshop

IPaymentProvidersExtendedPurchaseService

RedirectToWebshop

catalogListingId

// Open the front page UnityIAPServices.StoreController(PaymentProvider.Name).PaymentProvidersExtendedPurchaseService.RedirectToWebshop();// Open a specific product page UnityIAPServices.StoreController(PaymentProvider.Name).PaymentProvidersExtendedPurchaseService.RedirectToWebshop(catalogListingId: "your-listing-id");

열기 전에 규정 준수 승인 필요

RedirectToWebshop

SetComplianceCheck

false

PurchasingUnavailable

StoreController(PaymentProvider.Name).PaymentProvidersExtendedPurchaseService    .SetComplianceCheck(async context => await ShowComplianceDialog(context));

웹숍 열기 방법 제어

IPaymentProvidersExtendedPurchaseService

SetWebshopPresentationMode(CheckoutPresentationMode)

SetCheckoutPresentationMode

수동 연동

Application.OpenURL

storefront-link

GET

https://webshop.services.api.unity.com/v1/projects/{projectId}/environments/{environmentId}/storefront-link

• 퍼블리시된 프로덕션 환경은 라이브 공개 스토어프론트 URL을 반환합니다. 라이브 URL은 익명으로 확인됩니다.
• 비프로덕션 환경 또는 퍼블리시되지 않은 프로덕션 환경은 수명이 짧은 초안 미리보기 URL을 반환합니다.

source=draft

https://webshop.services.api.unity.com/v1/projects/{projectId}/environments/{environmentId}/storefront-link?source=draft

• 액세스 토큰은 초안 미리보기를 확인할 때

  storefront-link

  요청을 승인합니다.

  Authorization: Bearer

  헤더에 액세스 토큰을 전송합니다.
• 세션 토큰은 브라우저에서 플레이어를 인증합니다. 스토어를 열기 직전에 단기간의 단일 사용 제한 토큰을

  GenerateRestrictedTokenAsync

  로 채운 다음 해당 세션 토큰을 해결된 URL에

  sessionToken

  쿼리 파라미터로 추가합니다.

using System;using System.Collections;using System.Collections.Generic;using Unity.Services.Authentication;using UnityEngine;using UnityEngine.Networking;public class WebshopLauncher : MonoBehaviour{    // Replace these with the values from your Unity Cloud project and webshop configuration.    const string ProjectId       = "<your-project-id>";    const 문자열 EnvironmentId = "<your-environment-id>"; // API 요청 경로에서 사용    const 문자열 EnvironmentName = "production"; // 스토어 URL에 사용됨    const 문자열 StorefrontLinkEndpoint =        "https://webshop.services.api.unity.com/v1/projects/{0}/environments/{1}/storefront-link";    // draftPreview: request source=draft to preview unpublished changes even on a live env.    public void OpenShop(string locale, string currency, bool draftPreview = false)    {        StartCoroutine(OpenShopRoutine(locale, currency, draftPreview));    }    IEnumerator OpenShopRoutine(문자열 로케일, 문자열 통화, bool draftPreview)    {        var signedIn = AuthenticationService.Instance.IsSignedIn;        // The access token is required for draft previews; live storefronts open anonymously        // and ignore any token sent. 플레이어가 로그인할 때마다 전송합니다.        if (draftPreview && !signedIn)        {            Debug.LogWarning("WebshopLauncher: draft preview requires the player to be signed in.");            yield break;        }        // 1. Webshop 서비스에 스토어프론트 URL을 묻습니다.        var endpoint = string.Format(StorefrontLinkEndpoint, ProjectId, EnvironmentId);        if (draftPreview)            엔드포인트 += "?source=draft";        using var request = UnityWebRequest.Get(endpoint);        request.SetRequestHeader("Accept", "application/json");        if (signedIn)            request.SetRequestHeader("Authorization", $"Bearer {AuthenticationService.Instance.AccessToken}");        yield return request.SendWebRequest();        if (request.result != UnityWebRequest.Result.Success)        {            Debug.LogError($"WebshopLauncher: storefront-link request failed " +                           $"({request.responseCode}): {request.error}");            yield break;        }        var link = JsonUtility.FromJson<StorefrontLinkResponse>(request.downloadHandler.text);        if (link == null || string.IsNullOrEmpty(link.storefrontUrl))        {            Debug.LogError("WebshopLauncher: storefront-link response did not contain a storefrontUrl.");            yield break;        }        // 2. 웹숍 리디렉션을 위한 수명이 짧고 일회용으로 제한된 토큰을 사용합니다.        var tokenOptions = new RestrictedTokenOptions        {            서비스 = 새로운 목록<string> { "no-svc" }, // 실제 서비스에 대해 ID 토큰을 사용할 수 없음            SingleUse = true, // 첫 새로고침 시점에 웹숍에서 사용됩니다.            TtlSeconds = 60, // 리디렉트 직전에 틴트됩니다.        };        var tokenTask = AuthenticationService.Instance.GenerateRestrictedTokenAsync(tokenOptions);        yield return new WaitUntil(() => tokenTask.IsCompleted);        if (tokenTask.IsFaulted)        {            Debug.LogError($"WebshopLauncher: failed to generate restricted token: {tokenTask.Exception}");            yield break;        }        // 3. 상점을 엽니다.        var sessionToken = tokenTask.Result.SessionToken;        var shopUrl = BuildShopUrl(link.storefrontUrl, sessionToken, locale, currency);        Application.OpenURL(shopUrl);    }    정적 문자열 BuildShopUrl(문자열 storefrontUrl, 문자열 sessionToken, 문자열 로케일, 문자열 통화)    {        var url = storefrontUrl;        url = AppendParam(url, "sessionToken", sessionToken);        url = AppendParam(url, "projectId", ProjectId);        url = AppendParam(url, "environment", EnvironmentName);        url = AppendParam(url, "locale", locale);        url = AppendParam(url, "currency", currency);        return url;    }    정적 문자열 AppendParam(문자열 URL, 문자열 키, 문자열 값)    {        if (string.IsNullOrEmpty(value))            return url;        var separator = url.Contains("?") ? '&' : '?';        return $"{url}{separator}{key}={UnityWebRequest.EscapeURL(value)}";    }    [직렬화 가능]    StorefrontLinkResponse 클래스    {        public string storefrontUrl;        public bool live;    }}

들어오는 딥 링크 처리

URL 체계 등록

• iOS 및 macOS: Edit > Project Settings > Player > Other Settings > Supported URL schemes에서 스키마를 추가합니다. Unity는 빌드 시 빌드된 앱의

  Info.plist

  (

  CFBundleURLTypes

  )에 기록합니다. 모든 빌드에서 재생되는 생성된

  Info.plist

  를 수동으로 편집하는 것보다 이것을 선호합니다.
• Android: 사용자 지정 메인 매니페스트 또는 Gradle 매니페스트 템플릿을 통해 활동에

  <data android:scheme="mygame" />

  항목이 있는

  intent-filter

  를 추가합니다.

런타임 시점에 링크 처리

Application.deepLinkActivated

Application.absoluteURL

void Awake(){    // Links that arrive while the game is running.    Application.deepLinkActivated += OnReturnFromWebshop;    // Cold start: the deep link launched the game.    if (!string.IsNullOrEmpty(Application.absoluteURL))        OnReturnFromWebshop(Application.absoluteURL);}void OnReturnFromWebshop(string url){    // Handle the post-purchase return: the shop appends ?status=success    // (and playerId when available) after a completed purchase.    if (new Uri(url).Query.Contains("status=success"))    {        // Purchase completed on the web — refresh the player's entitlements.    }    // The Connect to game sign-in link is reopened by the SDK automatically,    // so it needs no handling here.}

status=success

상점 열기 테스트

draftPreview: true

OpenShop

source=draft

1. 모바일 디바이스에서 게임을 빌드하고 설치합니다.
2. 장치의 시스템 브라우저를 실행하도록

   OpenShop

   를 호출하는 게임 내 버튼을 트리거합니다.
3. 브라우저가 URL에 로케일과 통화를 사용하여 확인된 스토어프론트 URL로 열립니다. 초안은 환경 범위의 미리보기 URL을 엽니다. 라이브 스토어가

   shop.unity.com/{studio}/game/{slug}

   를 열립니다.
4. 스토어가 인증되지 않은 랜딩 페이지가 아닌 인증된 제품 목록으로 열립니다.
5. 샌드박스 구매를 완료합니다. 테스트 자격 증명은 관련 IAP 결제 제공업체의 샌드박스 기술 자료를 참고하십시오.
6. 초안이 예상대로 작동하면

   draftPreview: false

   에

   OpenShop

   를 호출하고 실시간으로 게시된 스토어에 대해 테스트를 반복합니다.

sessionToken

projectId