将网上商店集成到 Unity 游戏中

先决条件

• 集成应用内购的 Unity 项目。
• 项目中的 Authentication SDK（3.7.1 或更高版本）。
• 目标环境中的一个网上商店。

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

从游戏中打开网上商店

使用 SDK helper

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

  标记创建短暂的一次性受限令牌，然后将会话令牌作为

  sessionToken

  查询参数附加到解析的 URL。

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 string EnvironmentId = "<your-environment-id>"; // 在 API 请求路径中使用    const string EnvironmentName = "production"; // 在商店 URL 中使用    const string 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(string locale, string currency, 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.");            return break;        }        // 1.向 Webshop 服务询问店面 URL。        var endpoint = string.Format(StorefrontLinkEndpoint, ProjectId, EnvironmentId);        if (draftPreview)            endpoint += "?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}");            return 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.");            return break;        }        // 2.为 Webshop 重定向生成一个短暂的一次性受限令牌。        var tokenOptions = new RestrictedTokenOptions        {            Services = new List<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}");            return break;        }        // 3.打开商店。        var sessionToken = tokenTask.Result.SessionToken;        var shopUrl = BuildShopUrl(link.storefrontUrl, sessionToken, locale, currency);        Application.OpenURL(shopUrl);    }    static string BuildShopUrl(string storefrontUrl, string sessionToken, string locale, string currency)    {        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;    }    static string AppendParam(string url, string key, string value)    {        if (string.IsNullOrEmpty(value))            return url;        var separator = url.Contains("?") ? '&' : '?';        return $"{url}{separator}{key}={UnityWebRequest.EscapeURL(value)}";    }    [可序列化]    class 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. 当草案按预期工作时，请向

   OpenShop

   发出

   draftPreview: false

   电话，然后针对实际发布的商店重复测试。

sessionToken

projectId