手動ワークフロー

1. .NET プロジェクトの作成:Cloud Code モジュールは、ゲームクライアントが呼び出すことのできるエンドポイントを公開する単純な .NET プロジェクトです。
2. Cloud Code Authoring パッケージのインポート:Cloud Code Authoring パッケージをインストールして、呼び出せるエンドポイントを作成します。
3. プロジェクト内部のモジュールエンドポイントの作成:ゲームクライアントから呼び出せるゲームロジックを定義します。
4. コードのパッケージ化:プロジェクトのアセンブリを生成し、それらをアーカイブにパッケージ化します。
5. プロジェクトのデプロイ:アーカイブを Cloud Code サービスにデプロイします。
6. モジュールエンドポイントの呼び出し:ゲームクライアントからモジュールエンドポイントを呼び出します。

.NET プロジェクトの作成

JetBrains Rider

1. File (ファイル) > New (新規) を選択します。
2. クラスライブラリ (.NET Core または .NET Framework) を選択します。
3. モジュールに名前を付けます。
4. Create (作成) を選択します。

Microsoft Visual Studio

1. File (ファイル) > New Solution (新しいソリューション) を選択します。
2. .Net クラスライブラリを選択します。
3. Next (次へ) を選択します。
4. モジュールに名前を付けます。
5. Create (作成) を選択します。

Cloud Code Authoring パッケージのインポート

JetBrains Rider

1. Tools (ツール) > NuGet > Show NuGet Packages (NuGet パッケージの表示) を選択します。

2. Com.Unity.Services.CloudCode.Core

   を検索します。
3. 最新バージョンをプロジェクトにインストールします。

Microsoft Visual Studio

1. プロジェクト > Manage NuGet Packages (NuGet パッケージの管理) を右クリックします。

2. Com.Unity.Services.CloudCode.Core

   を検索します。
3. Add Package (パッケージの追加) を選択します。

モジュールエンドポイントの作成

CloudCodeFunction

name

SayHello

using Unity.Services.CloudCode.Core;namespace ExampleModule;public class MyModule{    [CloudCodeFunction("SayHello")]    public string Hello(string name)    {        return $"Hello, {name}!";    }}

コードのパッケージ化

linux-x64

ReadyToRun

• アセンブリの生成方法の詳細については、パッケージコード を参照してください。
• このプロセスを自動化する方法の詳細については、ローカルデプロイの自動化 を参照してください。

JetBrains Rider

1. Run (実行) > Edit Configurations (設定の編集) を選択します。
2. + を選択します。
3. Publish to folder (フォルダーに公開) を選択します。
4. 設定に名前を付けます。
5. Target location (ターゲットの場所) を、ビルド出力を格納する場所に設定します。
6. Release | Any CPU (リリース | 任意の CPU) 設定を選択します。
7. linux-x64 ターゲットランタイムを選択します。
8. (任意) Enable ReadyToRun compilation (ReadyToRun コンパイルの有効化) を有効にします。
9. Apply (適用) を選択します。

Microsoft Visual Studio

1. ソリューションを右クリックしてから、Publish (公開) を選択します。
2. 画面のステップに従って、ファイルをローカルに格納します。
3. Show All Settings (すべての設定の表示) を選択します。
4. ターゲットランタイムを linux-x64 に設定します。
5. Save (保存) を選択します。
6. Publish (公開) を選択します。

アセンブリの圧縮

bin/Release/net6.0/linux-x64/publish

zip ExampleModule.ccm *

zip -r ExampleModule.ccm path/to/your/project/bin/Release/net6.0/linux-x64/publish/*

モジュールプロジェクトのデプロイ

UGS CLI の設定

1. UGS CLI をインストール します。
2. 以下のコマンドを使用して、プロジェクト ID と環境を設定します。
   

   ugs config set project-id <your-project-id>

   
   

   ugs config set environment-name <your-environment-name>

3. Cloud Code と 環境管理 に必要なロールでサービスアカウントを設定します。認証の取得 を参照してください。

モジュールのデプロイ

ugs deploy <path-to-ccm-file>

ゲームからのモジュール関数の呼び出し

前提条件

プロジェクトのリンク

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. Unity Dashboard の 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 を初期化します。

await AuthenticationService.Instance.SignInAnonymouslyAsync();

モジュール関数の呼び出し

1. Services Core SDK を初期化します。Cloud Code を呼び出す前に、Services Core 名前空間 (

   Unity.Services.Core

   ) をインポートすることによりゲームコード内で Unity Services を初期化し、

   InitializeAsync

   メソッドを呼び出します。
2. 呼び出しの認証を行います。Cloud Code への各呼び出しは認証される必要があり、プレイヤーが Cloud Code サービスにアクセスするには有効なプレイヤー ID とアクセストークンが必要です。認証 を参照してください。

   SignInAnonymouslyAsync

   メソッドを呼び出して、匿名認証の使用の準備をすることをお勧めします。
3. モジュール関数を呼び出します。Cloud Code SDK を使用して、

   CallEndpointModuleAsync

   メソッドを使用するモジュール関数を呼び出します。

CallEndpointModuleAsync

インテグレーションのサンプル

ExampleModule

SayHello

using System.Collections.Generic;using Unity.Services.Authentication;using Unity.Services.CloudCode;using Unity.Services.Core;using UnityEngine;public class TestModule : 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            string result = await CloudCodeService.Instance.CallModuleEndpointAsync("ExampleModule", "SayHello", new Dictionary<string, object> {{"name", "World"}});            Debug.Log(result);        }        catch (CloudCodeException exception)        {            Debug.LogException(exception);        }    }}

Hello, World!