VKC Attribute Property

VKCAttributeProperty_1

概要

SDK9以降で登場したVKC Attribute Propertyを使うことで、Vket Cloudのプロパティ機能を設定することができます。

プロパティ機能はItemに対してキーと値を持たせる方法で、コンポーネント間の値渡しやUnityエディタ上での動作カスタマイズといった使用方法が可能です。

本ページでは、何かと便利なVKC Attribute PropertyとVket Cloudのプロパティ機能について紹介します。

VKC Attribute Property実装手順

1. アイテムとなるオブジェクトにアタッチ

VKCAttributeProperty_2

VKC Item Field、 VKC Item Object、 VKC Item Activityなど、ビルド時にアイテムとなるオブジェクトに対しVKC Attribute Propertyをアタッチします。

2. VKC Attribute PropertyにKeyとValueを入力

Listの「+」ボタンを押すことで、KeyとValueの入力欄が表示されます。

プロパティの仕組み

Vket Cloudのプロパティ機能は、キー(Key)に対応する値(Value)を保持する機能です。
保持した値はHeliScriptで読み込んだり、上書きしたりすることが可能です。

VKCAttributeProperty_3

KeyおよびValueはいずれもString型として保持されます。

これで、VKC Attribute Propertyの設定が完了です。

VKCAttributeProperty_4

ビルド後のScene.jsonのproperties項目に入力内容が反映されています。

HeliScriptでの使い方

設定したプロパティはHeliScriptで使うことができます。

ここでは、

Key：Vket　Value：Cloud
Key：SDK　Value：12.1

と設定されたアイテムGameObjectを例に紹介します。

1. GetProperty

Item.GetProperty(string Key)では、アイテムが持つプロパティのKeyに対応するValueを取得します。

// サンプルコード(コンポーネント構造無視)

Item m_Item;
m_Item = hsItemGet("GameObject");

string Value;
Value = m_Item.GetProperty("Vket");
hsSystemWriteLine("%s" % Value); //「Cloud」と出力される

2. SetProperty

Item.SetProperty(string Key)では、アイテムが持つプロパティのKeyに対応するValueを変更します。

// サンプルコード(コンポーネント構造無視)

Item m_Item;
m_Item = hsItemGet("GameObject");

m_Item.SetProperty("Vket","Chan");

string Value;
Value = m_Item.GetProperty("Vket");
hsSystemWriteLine("%s" % Value); //「Chan」と出力される

3. OnChangedProperty

OnChangedProperty(string Key, string Value)は、プロパティの変更が発生した際に実行されるコールバックです。
SetPropertyで特定のキーに対し同一の値が入力され変更が発生しなかった場合には実行されません。

// サンプルコード(コンポーネント構造無視)

Item m_Item;
m_Item = hsItemGet("GameObject");

m_Item.SetProperty("SDK","12.1");
m_Item.SetProperty("Vket","Chan");
m_Item.SetProperty("SDK","12.2");
m_Item.SetProperty("Vket","Chan");

public void OnChangedProperty(string Key, string Value){
  hsSystemWriteLine("Changed %s, %s" % Key % Value);
  if(Key == "Vket"){
    hsSystemWriteLine("Vket Changed");  
  }
}

// 上記の場合、
// 6行目　SDKは初期Valueが12.1のためコールバック実行なし
// 7行目　Vketは初期ValueがCloudのためコールバック実行
// 8行目　SDKはValueが12.1のためコールバック実行
// 9行目　Vketは7行目でValueがChanとなっているためコールバック実行なし
// となり、
// Changed Vket, Chan
// Vket Changed
// Changed SDK, 12.2
// が出力される

HeliScriptでは、以上の3通りの関数が用意されています。

注意点

1. SetProperty / GetPropertyする際は対象となるアイテムに注意

アイテムごとに異なるプロパティを設定することが可能です。

HeliScript上で対象となるアイテムを間違えると、上手く動作しない場合があるので、気を付けましょう。

Note

更新：SDK12.x及び以降のバージョンでは、プロパティが存在しない際にSetPropertyを行った場合は新たにプロパティを追加するように変更されました。
SDK9.11現在、対象となるプロパティが存在しないのにSetPropertyを行おうとした場合、エラー文も出ずに他のHeliScriptの動作に影響を及ぼす場合があります。

2. KeyおよびValueはString型

少し上でも解説した通り、KeyおよびValueはString型となるため、String型以外の変数を扱う場合、SetPropertyやGetPropertyする際に型変換を行う必要があります。

型変換を行わずにSetPropertyやGetPropertyした場合、nullとなります。