Unity Runtime からの呼び出し

前提条件

プロジェクトのリンク

1. Unity エディターで、Edit (編集) > Project Settings (プロジェクト設定) > Services (サービス) の順に選択します。
2. プロジェクトをリンクします。
   • プロジェクトに Unity プロジェクト ID がない場合:
     1. Create a Unity Project ID (Unity プロジェクト ID の作成) > Organizations (組織) の順に選択し、ドロップダウンメニューから組織を選択します。
     2. Create project ID (プロジェクト ID を作成) を選択します。
   • 既存の Unity プロジェクト ID がある場合:
     1. Use an existing Unity project ID (既存の Unity プロジェクト ID を使用) を選択します。
     2. ドロップダウンメニューから組織とプロジェクトを選択します。
     3. Link project ID (プロジェクト ID をリンク) を選択します。

UnityEditor.CloudProjectSettings.projectId

SDK のインストール

1. Unity エディターで、Window (ウィンドウ) > Package Manager (パッケージマネージャー) を開きます。
2. Package Manager で、Unity Registry (Unity レジストリ) のリストビューを選択します。

3. com.unity.services.cloudcode

   を検索するか、リストから Cloud Code パッケージを探します。
4. このパッケージを選択し、Install (インストール) をクリックします。

SDK の設定

1. Cloud Code サービスダッシュボードページを介してサービスが有効になっていることを確認します。
2. Cloud Code と Authentication SDK の両方をインストールしたことを確認します。
3. Edit (編集) > Project Settings... (プロジェクト設定...) > Services (サービス) を選択して、Unity エディター内からクラウドプロジェクトにサインインします。
4. Unity エディターで新しい C# Monobehaviour スクリプトを作成します。Unity マニュアルの スクリプトの作成と使用 を参照してください。
5. スクリプトで、await

   UnityServices.InitializeAsync()

   を使用して Core SDK を初期化します。
6. スクリプトで、Authentication SDK を初期化します。

典型的なワークフロー

1. Unity Engine 内で C#

   MonoBehaviour

   スクリプトを作成します。Unity - マニュアル:スクリプトの作成と使用 を参照してください。

2. MonoBehaviour

   スクリプト内で、Unity Authentication サービスを設定します。

3. MonoBehaviour

   スクリプト内で、Cloud Code SDK の呼び出しを追加します。

4. MonoBehaviour

   スクリプトをゲームオブジェクトにアタッチします。エディターのスクリプト に関するドキュメントを参照してください。
5. Play (再生) を選択し、プロジェクトを実行して Cloud Code の動作を確認します。

認証

await AuthenticationService.Instance.SignInAnonymouslyAsync();

using Unity.Services.Authentication;using System.Threading.Tasks;using Unity.Services.Core;using UnityEngine;public class AuthenticationExample : MonoBehaviour{    internal async Task Awake()    {        await UnityServices.InitializeAsync();        await SignInAnonymously();    }    private async Task SignInAnonymously()    {        AuthenticationService.Instance.SignedIn += () =>        {            var playerId = AuthenticationService.Instance.PlayerId;            Debug.Log("Signed in as: " + playerId);        };        AuthenticationService.Instance.SignInFailed += s =>        {            // Take some action here...            Debug.Log(s);        };        await AuthenticationService.Instance.SignInAnonymouslyAsync();    }}

Cloud Code モジュールエンドポイントの呼び出し

Using Unity.Services.CloudCode;

HelloWorld

RollDice

using System;using System.Threading.Tasks;using Unity.Services.CloudCode.Core;namespace HelloWorld;public class HelloWorld{    public class Response    {        public Response(int roll, int sides)        {            Roll = roll;            Sides = sides;        }        public int Roll { get; set; }        public int Sides { get; set; }    }    [CloudCodeFunction("RollDice")]    public async Task<Response> RollDice(int diceSides)    {        var random = new Random();        var roll = random.Next(1, diceSides);        return new Response(roll, diceSides);    }}

エディターのバインディングの使用

RollDiceExample

using Unity.Services.Authentication;using Unity.Services.CloudCode;using Unity.Services.CloudCode.GeneratedBindings;using Unity.Services.Core;using UnityEngine;public class RollDiceExample : MonoBehaviour{    private async void Start()    {        // Initialize the Unity Services Core SDK        await UnityServices.InitializeAsync();        // Authenticate by logging into an anonymous account        await AuthenticationService.Instance.SignInAnonymouslyAsync();        try        {            // Call the function within the module and provide the parameters we defined in there            var module = new HelloWorldBindings(CloudCodeService.Instance);            var result = await module.RollDice(6);            Debug.Log($"You've rolled {result.Roll}/{result.Sides}");        }        catch (CloudCodeException exception)        {            Debug.LogException(exception);        }    }}

CallModuleEndpointAsync の使用

CloudCodeService.Instance

CallModuleEndpointAsync

        /// <summary>/// Calls a Cloud Code function./// </summary>/// <param name="module">Cloud Code Module to call</param>/// <param name="function">Cloud Code function to call.</param>/// <param name="args">Arguments for the cloud code function. Will be serialized to JSON.</param>/// <typeparam name="TResult">Serialized from JSON returned by Cloud Code.</typeparam>/// <returns>Serialized output from the called function.</returns>/// <exception cref="CloudCodeException">Thrown if request is unsuccessful.</exception>/// <exception cref="CloudCodeRateLimitedException">Thrown if the service returned rate limited error.</exception>Task<TResult> CallModuleEndpointAsync<TResult>(string module, string function, Dictionary<string, object> args = null);

• module

  パラメーターはモジュールの名前です。

• function

  パラメーターは、

  CloudCodeFunction

  属性でラベルを付けたモジュールエンドポイントの名前です。

• args

  パラメーターは、モジュールエンドポイントに渡すパラメーターのディクショナリです。

RollDiceExample

using System.Collections.Generic;using UnityEngine;using Unity.Services.Authentication;using Unity.Services.CloudCode;using Unity.Services.Core;public class RollDiceExample : MonoBehaviour{    // ResultType structure is the serialized response from the RollDice script in Cloud Code    private class ResultType    {        public int Roll;        public int Sides;    }    // Call this method    public async void CallMethod()    {        await UnityServices.InitializeAsync();        // Sign in anonymously into the Authentication service        if (!AuthenticationService.Instance.IsSignedIn) await AuthenticationService.Instance.SignInAnonymouslyAsync();        // Call out to the RollDice endpoint in the HelloWorld module in Cloud Code        var response = await CloudCodeService.Instance.CallModuleEndpointAsync<ResultType>("HelloWorld", "RollDice", new Dictionary<string, object>( ) { { "diceSides", 6 } });        // Log the response of the module endpoint in console        Debug.Log($"You rolled {response.Roll} / {response.Sides}");    }}

スクリプトの実行

Start()

CallMethod()

    public void Start(){    CallMethod();}