Unity向けのSDK / SDKを使ってアプリケーションのUIを設定する方法
  ドキュメントに戻る

Unity向けのSDK

SDKを使ってアプリケーションのUIを設定する方法

デモプロジェクトには、UIビルダーが含まれています。UIビルダーは、アプリケーションのUIの外観を設定することができます。

色、スプライトとフォントのUI要素の視覚プロパティを編集することで、UIを変更することができます。これらのプロパティは1つのテーマにまとめられます。Unityのテーマと視覚コンポーネントはデコレーターによって接続されます。視覚プロパティを変更すると、デコレーターがUnityコンポーネントの視覚を変更します。

ウィジェットを使用して、UI要素を同じタイプの他の要素に置き換えることができます。これらのウィジェットは、独立した、簡単に交換可能なパーツで、プレハブの形式をしています。

UIは2つの独立したパーツで構成されています:

テーマを操作する

テーマエディター

テーマエディターを開くには、UnityエディターのメインメニューからWindow > Xsolla > UI Themes Editorを開きます。

テーマエディターのUIには、以下のコンポーネントが含まれています:

  • テーマの選択と適用に使用されるテーマ名のボタン。

お知らせ
アプリケーションの実行中は、ThemesLibraryクラスのSetCurrentThemeByNameスタティックメソッドによってのみ、テーマを変更することができます。このメソッドにパラメータとしてテーマ名を渡します。
  • Refreshボタン — テーマのプロパティやその変更をアプリケーションのUIに適用することができます。
  • Auto Refreshボックス — テーマのプロパティやその変更をアプリケーションのUIに適用することができます。
  • Themesセクション — 既存のテーマのリストが含まれています。
  • Colorsセクション — テーマの色のリストが含まれています。
  • Spritesセクション — テーマスプライトのリストが含まれています。
  • Fontsセクション — テーマフォントのリストが含まれています。

リストに対して次のアクションを実行できます:

  • 新しい要素を追加するには、リストの下部にある+アイコンをクリックします。
  • 選択した要素を削除するには、リストの下部にある-アイコンをクリックします。
  • 順番を変更するには、=アイコンをクリックしたまま、要素をリストの必要な位置にドラッグします。
  • 要素の名前を変更するには、フィールドのテキストを要素名に変更します。

プロパティ値は、標準的なUnityの方法で変更されます:

  • 色を変更するには、プロパティのフィールドをクリックして、新しい値を選択します。
  • フォントやスプライトの変更は、以下のいずれかの方法で行うことができます:
    • アセットをプロパティフィールドにドラッグします。
    • アイコンをクリックして、アセットを選択します。

テーマライブラリ

テーマライブラリは、ScriptableObjectクラスから継承され、Resources/UIBuilder/ThemesLibraryディレクトリにあります。

お知らせ
テーマライブラリのディレクトリを変更することはお勧めしません。それは、確定したリソースディレクトリからのリクエストに応じてロードされるsingletonオブジェクトです。

UI要素をテーマに接続する

適用されたテーマに応じて、UI要素の視覚を変化させるには:

  1. オブジェクトにデコレーターを追加して設定します。
  2. プロパティプロバイダコンポーネントをオブジェクトに追加して設定します。

デコレーター

デコレーターとは、Unityの標準的なUI要素にテーマのプロパティ(カラー、スプライト、フォント)を適用し、それらを変更するコンポーネントです。

デコレーターには、プロパティの値ではなく、プロパティIDと、UI要素へのリンク(画像やテキスト)が含まれます。一般的にデコレーターは、テーマとUI要素をつなぐコネクターのようなものです。デコレーターの設定は、Inspectorパネルで行います。

デコレーターのリスト:

  • ImageColorDecorator — 画像の色を変更する
  • ImageSpriteDecorator — 画像のスプライトを変更する
  • TextFontDecorator — テキストの色を変更する
  • TextColorDecorator — テキストのフォントを変更する

デコレーターは、以下のイベントが発生した場合に、要素のプロパティを変更します:

  • オブジェクトは、テーマエディターやゲームの実行中に有効になります。
  • 現在のテーマは、エディターまたはゲームの実行中に変更されます。
  • オブジェクトプロパティとテーマ間の接続は、Inspectorパネルで変更されます。
  • プロパティの値はテーマエディターで変更されます。
  • オブジェクトのプレハブがテーマエディターで編集できるようになります。

UI要素とテーマの間に関連性を持たせるには、次のようにします:

  1. デコレーターコンポーネントをオブジェクトに追加します。
  2. テーマから物件のIDを選択します。

デコレーターがオブジェクトに追加されると、このオブジェクト上で必要なUI要素を探し、それをComp変数に割り当てようとします。

デコレーターの応用例:

画像オブジェクトにImageColorDecoratorのデコレータを追加します。この例では、色のMain Button IDを指定しています。その結果、Main Buttonのテーマで指定された色が画像に使用されます。

デコレーターは、ゲームがプレイされ、ユーザーがカーソルでオブジェクトを指したり、オブジェクトをクリックしたりしている間に、コンポーネントの視覚を動的に変更することができます。

UI要素の視覚を動的に変更するこには:

  1. デコレーターコンポーネントをオブジェクトに追加します。
  2. テーマから物件のIDを選択します。
  3. DecoratorPointerEventsコンポーネントをオブジェクトに追加します。このコンポーネントは、オブジェクトをクリックしたり、カーソルをポイントしたりするイベントをトラッキングします。
  4. デコレーターコンポーネントで、TransitionModeの変数値をOverrideに変更します。
  5. 追加されたDecoratorPointerEventsコンポーネントを、デコレータのPointerEvents変数に割り当てます。
  6. カーソルでポイントしたときの視覚を変更するには:
    1. Override on hoverボックスにチェックを入れます。
    2. ボックスの近くのフィールドで、テーマからプロパティのIDを選択します。
  7. 以下をクリックした時、視覚を変更します:
    1. Override on pressにチェックを入れます。
    2. ボックスの近くのフィールドで、テーマからプロパティのIDを選択します。

視覚をダイナミックに変化させるデコレーターの応用例:

ImageColorDecoratorのデコレーターを画像オブジェクトに追加します。この例では、色のMain Button IDと、カーソルをポイントした時の色のMain Button Hover IDを指定しています。その結果、Main Buttonのテーマで指定された色が画像に使用されます。カーソルをポイントする時、Main Button Hoverのテーマで指定された色に変更されます。

プロパティプロバイダー

プロパティプロバイダーは、テーマプロパティのコンテナの形をしたクラスです。ユーザーコードとテーマの間の接続をより便利にするために使用されます。

プロパティプロバイダーのリスト:

  • ColorProvider — 色のプロパティへのリンクが含まれています。
  • SpriteProvider — スプライトのプロパティへのリンクが含まれています。
  • FontProvider — フォントのプロパティへのリンクが含まれています。

すべてのプロパティプロバイダーには、Inspectorパネルを介したより便利な設定のためのPropertyDrawerがあります。

プロパティプロバイダーを構成し、コードでプロパティ値を取得するには:

  1. オブジェクトにプロパティプロバイダーコンポーネントを追加します。
  2. テーマからプロパティのIDを選択します。

プロパティプロバイダの設定例:

  1. スクリプトの中で、変数を宣言し、プロパティプロバイダーコンポーネントを割り当てます。
  2. 色の値を取得するには、GetValueメソッドを呼び出します。

スクリプトの例:

Copy
Full screen
Small screen
public class ProviderExample : MonoBehaviour
{

  [SerializeField] private ColorPrivider ColorPrivider;

  private void Start()
  {
      Color color = ColorProvuder.GetValue();
  }

}

ウィジェットを操作する

ウィジェットエディター

ウィジェットエディターを開くには、Unityエディターのメインメニューに移動し、Window > Xsolla > UI Widgets Editorを開きます。

ウィジェットエディターUIには、次のコンポーネントが含まれています:

  • Refreshボタン — プレハブでウィジェットの変更を適用できます。
  • Auto Refreshボックス — プレハブでウィジェットの変更を自動的に適用できます。
  • Widgetsセクション — ウィジェットのリストが含まれています。

ウィジェットのリストに対して次のアクションを実行できます:

  • 新しいウィジェットを追加するには、リストの下部にある+アイコンをクリックします。
  • 選択したウィジェットを削除するには、リストの下部にある-アイコンをクリックします。
  • 順番を変更するには、=アイコンをクリックしたまま、要素をリストの必要な位置にドラッグします。
  • ウィジェットの名前を変更するには、フィールドのテキストを要素名に変更します。
  • 次のいずれかの方法でフォントまたはスプライトを変更できます:

    • プレハブをウィジェットを使用してフィールドにドラッグします。
    • アイコンをクリックして、プレハブを選択します。

ウィジェットライブラリ

ウェジェットライブラリは、ScriptableObjectクラスから継承され、Resources/UIBuilder/WidgetsLibraryディレクトリにあります。

お知らせ
ウェジェットライブラリのディレクトリを変更することはお勧めしません。それは、確定したリソースディレクトリからのリクエストに応じてロードされるsingletonオブジェクトです。

UI要素をウィジェットに接続する

UIの要素を簡単に他の要素に置き換えるには、UIを構築する際にウィジェットを直接使用するのではなく、ウィジェットコンテナを使用する必要があります。そうすれば、コンテナで作られたウィジェットが、同じタイプのUI要素を変更するように単純に構成することができます。標準的なアプローチでは、すべてのウィジェットを手動で交換する必要があります。

コンテナは、子オブジェクトとしてウィジェットオブジェクトを作成し、RectTransformクラスのプロパティを設定することで、ウィジェットがコンテナ内のスペース全体を埋めるようにします。

UIエレメントオブジェクトにコンテナコンポーネントを追加する際、このオブジェクトはウィジェットを作成する際の親オブジェクトとして使用されます。

コンテナは、以下のイベントが発生すると、ウィジェットのプロパティを変更します:

  • Inspectorパネルで、オブジェクトのプロパティとウィジェットの接続が変更されます。
  • ウィジェットエディターでウィジェットのプレハブを変更します。

UI要素とウィジェットを接続するには:

  1. WidgetContainerコンポーネントをオブジェクトに追加します。
  2. ウィジェットIDを選択します。

お知らせ

ウィジェットコンテナを持つオブジェクトがプレハブの場合、コンテナの設定はプレハブ編集モードでのみ変更できます。これは、Unityプレハブ内の子オブジェクトの階層を、このモードでのみ変更できるためです。

ウィジェットを置き換えると、現在のウィジェットが削除され、新しいウィジェットが作成されます。オブジェクトとその接続の動作ロジックを設計する際には、この点に注意してください。

ウィジェットコンテナの使用例:

WidgetAオブジェクトでは、例としてRed Button IDを持つウィジェットを指定しています。その結果、WidgetAオブジェクトは、エディターでRed Buttonウィジェットに指定されたプレハブを使用して作成されます。

UIビルダーの構造

動作中、UIビルダーは以下のコンポーネントを使用しています:

  • UIProperty — 次のデータを持つオブジェクト:
    • プロパティのID
    • プロパティ名
    • 視覚データ(色、スプライト、フォントなど)

  • Theme — テーマコンポーネント。テーマは、UIの視覚を変更することができ、異なるグループ(色、スプライト、フォント)のプロパティのコレクションを表します。すべてのテーマには、名前と固有の識別子があります。テーマのプロパティには、プロパティのIDを使ってアクセスすることができます。
  • ThemesLibrary — プロジェクトに存在するすべてのテーマのライブラリ。また、現在のテーマの値が含まれており、この値を変更するためのメソッドを提供します。
  • ThemeDecorator — テーマのプロパティを参照し、そのプロパティの値を標準のUnity UIコンポーネントに適用するMonoBehaviourクラスのコンポーネント。例えば、ImageColorDecoratorデコレーターは、画像の色を変更するものです。
  • UIPropertyProvider — テーマのプロパティにアクセスするためのクラス。これらのコンポーネントを使用して、ユーザーコードとテーマのデータを簡単に接続します。例えば、ColorProviderクラスは、色に関するデータを提供します。
  • WidgetContainer — ウィジェット全体を変更できるMonoBehaviourクラスコンポーネント。
  • WidgetsLibrary — プロジェクトに存在するウィジェットのコレクション。このコンポーネントは、すべてのウィジェットのリストを含み、そのIDでウィジェットを取得するためのメソッドを提供します。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2023年10月10日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!