All content in this course uses:

クラスの目的を定めて C# クラスを実装し、変数の初期化とコンソール検証まで行ってポーション生成クラスを作成します。

 独自のポーション配置クラスを作成する

このチュートリアルでは、以下の活動を行います。

コードをより効率的にするためにクラスを書く

クラスの特別な関数を追加してレビューする

コンソールでスクリプトの変更を確認する


このチュートリアルを終えると、「Creator Kit：コーディング入門」のゲームで使う、独自のポーション配置クラスを作成するために必要な知識が身に付きます。

クラスがどのように機能するかを確認したので、SpawnerSampler スクリプトにクラスを作ってみましょう。クラスを使えばより効率的なコードを記述し、似たような関数をグループ化することができます。これは、ゲームのコードを作成する上で重要な事実です。パターンを見つけてそれを使い、思い通りに関数やプレイヤー体験を作成しましょう。

すでに知っていることを使って、ライフ回復ポーションを配置する時に使う角度を計算するクラスを作るところから始めましょう。

クラスを使用してコードをより効率的にする

まず、クラス宣言を追加します。これは、SpawnerSample スクリプトファイルの SpawnerSample クラスの閉じ波括弧の後に配置します。

 キーワードとその機能については、次のチュートリアルで詳しく説明します。

クラス宣言を書く

次に、この関数で行う作業を処理するために必要なデータのタイプを識別する必要があります。これを行うために、作成するクラスの目的について考えてください。

このクラスは、ポーションを配置する角度を決まった手順によって計算する必要があります。これを行うには、以下の値を保存できるようにしておく必要があります。

新しいポーションが配置されるたびに位置に追加する必要がある角度（

以上の考察より、次の方程式を計算すればいいことが分かります。

(新しく配置するポーションの位置を決める角度) = 

データ型を特定する

新しいクラス LootAngle で、方程式に必要なデータを格納する 2 つの int 型変数を宣言します。


 いま配置しようとしているポーションの位置を決める角度（この変数は 

 次にポーションを配置する位置を決めるために加算する角度（この変数は 

必要なデータ変数を宣言する

前のステップで考えたことに基づけば、新しい LootAngle クラスに以下のようなコードが追加されているはずです。

各命令はセミコロンで終了させ、コンパイラーがそれぞれ個別の命令であることを認識できるようにしておく必要があります。

変数宣言を確認する

最後に、次のポーションを配置する時に使う角度の値を計算する関数を追加する必要があります。

関数を追加する

このプロジェクトを通じて行ってきたように、すでに得た知識を使ってこの関数の重要な情報を見つけ出して、各部分がスクリプトで何をするかを理解してみてください。

 であり、void ではありません。これは、関数が何らかの命令を実行するだけでなく、結果（新しく配置するポーションの位置を決める角度）も返すためです。

このコードは、関数 NextAngle が整数（int 型の）値を返すことをコンパイラーに通知します。以前は関数で計算を行うものの結果を返さなかったため、void（「何もない」の意味）を使っていました。


この命令は、現在の角度を currentAngle と呼ばれる新しい変数に格納します。


次の命令は、次に配置するポーションの位置を決める角度を計算し、それを変数 

 に格納します。WrapAngle 関数は、角度の値を 0° から 360° の間に収めるように変換する、この Creator Kit にあらかじめ準備されている関数です。


この命令は、元の角度（命令を実行して値が増える前）を呼び出し元に返します。return キーワードの右側の値は、関数によって返される値になります。

関数の内容のレビュー

関数が必要な方程式の計算を実行していることを確認してみましょう。


この関数は、指定した増分（step）を現在の角度に追加することにより、新しく配置するポーションの位置をおのおの計算する必要があります。

として関数のレビューを始めましょう。


関数を初めて呼び出すと、以下のような処理が行われます。

 を返す



2 回目に関数が呼び出されると、以下のようになります。



呼び出されるたびに同じ手順が実行されます。

関数の計算を確認する

ほぼ関数が出来上がりました。あと欠けているものは、変数 

 クラスがメモリ内のこれら 2 つの値のためのスペースを予約する必要があることをコンピューターに伝えましたが、それらに値を割り当てませんでした。デフォルトでは、値は 

ここでたとえば Init という関数を記述して、これらの変数の値を、与えた引数で初期化することができます。しかし、クラスにはコンストラクターと呼ばれる非常に便利な機能がありますので、それを使いましょう。


コンストラクタ―が何をするのか調べてみましょう。


 SpawnerSample スクリプトで、Start 関数の上部（SpawnPotion の最初の呼び出しよりも前）に新しい行を作成します。

その行に次の命令を追加します。


特定のクラスの型を持つ新しい変数を作成する方法を学んだときのことを覚えているでしょうか。型名の後には、関数のように一組の丸括弧が続きます。これは、実際にはコンストラクターという関数を呼んでいるためです。

変数 angle と変数 step を初期化する

コンストラクターは、クラスとまったく同じ名前を持ち、その前に型（void など）が記述されていない特別な関数です。コンパイラーは、デフォルトで「隠し」コンストラクターを作成しますが、これは何もしません。これを自分で作成すると、個別に引数を指定できます。


自分でコンストラクターを作成するには、以下のようにします。


 変数 angle と step を初期化する命令の下に、以下のコードを追加します。

 完成したクラスは以下のようになります。皆さんが作ったクラスと比較してみてください。


これで、コンストラクターは 1 つの引数を取るようになりました。この引数は、NextAngle 関数が呼び出されるたびに加算される増分で、値が変数 

 に格納されます。また、変数 angle は0に初期化されます。




 SpawnerSample スクリプトの Start 関数に戻り、LootAngle 変数を作成する命令を次のように修正します。



これで OK です。初めてクラスを作り、それを使用して変数を作る手順を完了しました。

コンストラクターの引数を作成する

独自のクラスを作成したので、そのクラスを使用するようにスクリプトを更新する必要があります。

ポーションの配置に LootAngle クラスを使用するようにスクリプトを修正しましょう。


 SpawnerSample スクリプトの Start 関数を探す。


 Start 関数内の命令を以下のように書き換えます。

 変更をスクリプトに保存する。

Start 関数の内容を書き換える

開発時は、エディターで変更をテストすることが重要です。

 Unity エディターに戻り、コンソールウィンドウを確認する。




 エラー CS0122 が 5 つ表示されているはずです。

このエラーは、保護レベルの設定が原因で関数にアクセスできないことを意味します。

LootAngle.NextAngle() は皆さんが書いた関数です。LootAngle.LootAngle は、クラス LootAngle にある LootAngle という名前の関数です。つまり、これはコンストラクターです。

しかし、なぜそれらにアクセスできないのでしょうか。次のチュートリアルで、

 キーワードと、これらの関数にアクセスできるようにする方法について学習します。

変更をテストする

このチュートリアルでは、以下の活動を行いました。

SpawnerSample スクリプトでカスタムクラスを作成した

コンストラクターを使用して変数を初期化した

Unity エディターで変更をテストし、保護レベルのエラーが出ていることを確認した


次のチュートリアルでは、保護レベルのエラーを修正し、public キーワードについて学習します。また、継承の概念と、この概念を使ってより効率的なコードを作成する方法についても説明します。

Unity バージョン 2020.3