--- title: ZEPETOキャラクターコントローラー slug: world-sdk-guide-ja/gQGg-zepeto docTags: createdAt: 2024-09-02T08:34:13.135Z --- ZEPETO CharacterControllerは、シーンに読み込まれたZEPETOキャラクターの移動やカメラ制御などの機能を提供します。 CharacterControllerを活用するには、ZEPETOキャラクター作成スクリプトを書き、その後キャラクターをシーンに読み込む必要があります。 :::hint{type="info"} - 以下のガイドを参照してください。 \[[Zepetoキャラクターを作成する](docId\:X3HPJvYg3lwW0PU1r8k1s)] ::: CharacterControllerは、PCとモバイルの両方の入力に対応した事前定義されたキャラクター制御キーのマッピングを持っているため、読み込まれたキャラクターはプラットフォームに関係なく、シーン内で即座に操作できます。 PC環境では、キーボードとマウスを使用してキャラクターとカメラを制御できます。逆に、モバイル環境では、以下のスクリーンショットに示すように、バーチャルパッドを通じてキャラクターとカメラの操作が可能です。CharacterControllerのデフォルト設定を変更する柔軟性があります。 ::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-y0aKHnHVTa5amO5WZ3de2-20240904-102411.png" size="48" width="468" height="823" position="center" caption="モバイルデバイス画面（縦モード）" showCaption="true"} ::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-od7_ixpuD1cQLWp82T6te-20240904-102411.png" size="74" width="1237" height="697" position="center" caption="モバイルデバイス画面（横モード）" showCaption="true"} :::hint{type="success"} **👍 キャラクター操作に対応している入力インターフェースは以下の通りです：** **PC** - 移動：キーボードの矢印、WASD - ジャンプ：スペース - ダブルジャンプ：（左）シフト - ズーム：マウスホイール - 回転：画面ドラッグ **モバイル** - 移動：（画面左下）バーチャルパッド - ジャンプ：（画面右下）バーチャルパッドボタン - ズーム：（二本の指）画面ドラッグ - 回転：（一本の指）画面ドラッグ ::: ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-5ZVgE4TSKaKQQqYAy5nJP-20240904-102411.gif) キャラクターコントローラーのデフォルト設定を変更する柔軟性があります。 Hierarchyウィンドウで作成したZepetoPlayersオブジェクトを選択することで、Inspectorで各パラメータに適用されたコントローラー設定を表示および調整できます。 ![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-klW7t8E8HVT71kAkiiN19-20240904-102411.png) ZEPETOカメラは、作成時にLocalPlayerの上部頭部に焦点を合わせ、カメラ/キャラクターの動きに合わせて追従し続けます。 各アイテムの詳細に飛び込んでみましょう： ## カメラ | **パラメータ名** | **説明** | | ------------- | ---------------------------------------------------- | | プレハブ | これはローカルプレイヤーを追跡します。 | | ルックオフセット | カメラフォーカスの標準位置（キャラクターヘッドに基づく） | | ズーム（最大） | ズームアウト最大範囲 | | ズーム（最小） | ズームイン最大範囲 | | ズーム速度（基本速度） | ズームイン/アウト速度（入力値用） | | ズーム速度（ダンプ速度） | ズームイン/アウトの速度補間値（デルタタイム用） | | 回転（最大角度） | （垂直 + 方向）回転制限範囲 | | 回転（最小角度） | （垂直 - 方向）回転制限範囲 | | 回転（X軸ロック） | （垂直方向）回転がロックされているかどうか | | 回転速度（基本） | 回転速度（入力値用） | | 回転速度（ダンプ） | 回転速度補間値（デルタタイム用） | | 衝突レイヤー | カメラ衝突が適用されるレイヤー。
- プレイヤーレイヤーに設定されたレイヤーは適用されません。 | | キャラクターカリングを使用 | チェックを入れると、カメラがキャラクターと衝突したときにキャラクターカリングが適用されます。 | ## キャラクター | **パラメータ名** | **説明** | | -------------- | -------------------------------------------------------------------------------------------------------------------- | | スロープ制限 | キャラクターが登れる最も急なスロープ。 | | ステップオフセット | キャラクターが越えられる最高の障害物。 | | 最小移動距離 | キャラクターが移動できる最小の隙間を定義します。 | | シャドウ | キャラクターの影の視覚的表現。 | | アニメーションコントローラー | キャラクター用のアニメーターコントローラー。 | | 歩行速度 | 歩行入力イベントの移動速度。 | | 走行速度 | 走行入力イベントの移動速度。 | | ジャンプ力 | ジャンプ入力イベントのジャンプ高さ。 | | 歩行/走行閾値 | 移動入力に適用される歩行/走行の基準値（0-1）
- 走行閾値：歩行から走行動作に切り替えるために使用される基準値
- 歩行閾値：歩行動作の加速が適用される最大基準値 | | ダブルジャンプ | チェックされている場合、ダブルジャンプを許可します。
- ダブルジャンプ条件がチェックされている場合、ダブルジャンプのデフォルト入力は左シフトです。 | | 移動ターン | チェックされている場合、移動ターンを許可します。
- 有効にすると、キャラクターの瞬時の（0.1秒間隔）回転角度が90度を超えます。 | | 着地 | チェックされている場合、着地を許可します。
- ZEPETOキャラクターが高さから着地したときに表示される着地状態を切り替えます。
- 落下後に即座に移動したい場合は、着地オプションをオフに設定します。 | | 着地ロール | チェックされている場合、着地ロールを許可します。
- 着地ロール条件がチェックされている場合、垂直速度が18ユニットを超えるとキャラクターがロールします。着地時に水平方向の入力がある場合、着地ロール動作がトリガーされます。 | いくつかのパラメータは、Unityのキャラクターコントローラーコンポーネントの設定と一致します。さらなる明確さのために、リンクされたドキュメントを参照してください。 :::hint{type="info"} **📘 Unity CharacterController** [https://docs.unity3d.com/2020.3/Documentation/ScriptReference/CharacterController.html](https://docs.unity3d.com/2020.3/Documentation/ScriptReference/CharacterController.html) ::: ランタイム中にキャラクターコントローラーの属性をプログラム的に操作したい場合は、APIドキュメントを参照してください。 :::hint{type="info"} - 以下のガイドを参照してください。 \[[ZEPETO.Character.Controller API](https://developer.zepeto.me/docs/character-controller/)] ::: ## コントロール | **パラメータ名** | **説明** | | ------------------- | ------------------------------------------------------------------------- | | イベントシステム | イベントシステムはユーザー入力を処理し、それをUIコンポーネントに伝えます。ボタンクリック、ドラッグ、ドロップなどのインタラクションを処理します。 | | デフォルト入力アセットを使用 | デフォルト入力アセットトグル
- チェックを外すと、キーボードによる操作が不可能になります。 | | デフォルトVパッドコントローラーを使用 | Vパッド使用トグル
- チェックを外すと、Vパッドコントロールがアクセスできなくなります。 | | 垂直コントローラー | 垂直画面向けのV-padコントローラープリファブ。 | | 水平コントローラー | 水平画面向けのV-padコントローラープリファブ。 | ## フローティングUI (OnApp) アプリを通じてプレイする際、キャラクターに関連するUIを表示するかどうかを選択できます。 | パラメータ名 | 説明 | | ----------- | ------------------------------------------ | | ミニプロフィール | キャラクターをクリックしたときに、ミニプロフィールポップアップUIを表示するかどうか | | ニックネーム (私) | 自分のキャラクターのニックネームUIを表示するかどうか | | ニックネーム (他) | 他のキャラクターのニックネームUIを表示するかどうか | | バブルチャット (私) | 自分のキャラクターのバブルチャットUIを表示するかどうか | | バブルチャット (他) | 他のキャラクターのバブルチャットUIを表示するかどうか |