---
title: ZEPETO.Character.Controller - Deprecated Declarations
slug: world-sdk-guide-kr/zepetocharactercontroller-deprecated-declarations
docTags: 
createdAt: 2024-09-02T08:34:13.135Z
---

ZEPETO.Character.Controller 패키지의 다음 API 클래스는 더 이상 사용되지 않거나 구식입니다:

## ZepetoPlayers

| **제거할 선언**                                                                                                                           | **버전에서 사용 중단됨** | **대신 사용할 것**                     | **버전에서 제거됨** | **사용 중단 사유**                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------ | --------------- | -------------------------------- | ------------ | ---------------------------------------------------------------- |
| public motionV1Data: ZEPETO\_Character\_Controller\_StandardControl\_V1.CustomMotionData;                                            | 1.21.5          | 직접적인 대체 없음                       | -            | MotionController V1과 V2 사이에서 선택할 수 있는 옵션이 제거되었으며, 이제 사용 중단되었습니다. |
| public motionV2Data: ZEPETO\_Character\_Controller\_StandardControl\_V2.CustomMotionData;                                            | 1.21.5          | `characterData.customMotionData` | -            | MotionController V1과 V2 사이에서 선택할 수 있는 옵션이 제거되었으며, 이제 사용 중단되었습니다. |
| public static OnZepetoPlayersAwake: System.Action;                                                                                   | -               | 직접적인 대체 없음                       | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |
| public static OnZepetoPlayersDestroy: System.Action;                                                                                 | -               | 직접적인 대체 없음                       | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |
| public static isInitialized: boolean;                                                                                                | -               | `ZepetoPlayers.onInitialized`    | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |
| public setting: Setting;                                                                                                             | -               | 직접적인 대체 없음                       | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |
| public static isHorizontal: boolean;                                                                                                 | -               | 직접적인 대체 없음                       | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |
| public static gravity: number;                                                                                                       | -               | 직접적인 대체 없음                       | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |
| public CreatePlayer($id: string, $characterInfo: CharacterInfo, $isLocal: boolean, $spawnInfo: SpawnInfo)\:void;                     | -               | 직접적인 대체 없음                       | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |
| public CreateCharacter($characterInfo: CharacterInfo, $spawnInfo: SpawnInfo, $complete: System.Action$1)\:void;                      | -               | 직접적인 대체 없음                       | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |
| public CreateModel($characterInfo: CharacterInfo, $spawnInfo: SpawnInfo, $complete: System.Action$1\<UnityEngine.GameObject>)\:void; | -               | 직접적인 대체 없음                       | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |

## 카메라 데이터

| **제거할 선언**                                                                               | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**                                     |
| ---------------------------------------------------------------------------------------- | --------------- | ------------ | ------------ | ------------------------------------------------ |
| public speed: number;                                                                    | 1.21.5          | 직접적인 대체 없음   | -            | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.       |
| public sensitivity: number;                                                              | 1.21.5          | 직접적인 대체 없음   | -            | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.       |
| public useEnhancedOption: boolean;                                                       | 1.21.5          | 직접적인 대체 없음   | -            | 향상된 카메라가 기본 카메라로 설정되었으므로 항상 true를 반환하도록 변경되었습니다. |
| public enhancedOptionData: ZEPETO\_Character\_Controller\_CameraData.EnhancedOptionData; | 1.21.5          | 직접적인 대체 없음   | -            | 깊이가 변경되었습니다. 향상된 카메라가 기본 카메라로 설정되었기 때문입니다.       |



## 제페토카메라

| **제거할 선언**                                                                          | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**                                               |
| ----------------------------------------------------------------------------------- | --------------- | ------------ | ------------ | ---------------------------------------------------------- |
| public terrainClipDist: number;                                                     | 1.21.5          | 직접 대체 없음     | -            | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.                 |
| public castRadius: number;                                                          | 1.21.5          | 직접 대체 없음     | -            | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.                 |
| public zoomCalibration: number;                                                     | 1.21.5          | 직접 대체 없음     | 1.21.5       | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.                 |
| public rotateCalibration: number;                                                   | 1.21.5          | 직접 대체 없음     | 1.21.5       | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.                 |
| public additionalSpeed: number;                                                     | 1.21.5          | 직접 대체 없음     | 1.21.5       | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.                 |
| public additionalSensitivity: number;                                               | 1.21.5          | 직접 대체 없음     | 1.21.5       | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.                 |
| public enhancedOption: ZEPETO\_Character\_Controller\_ZepetoCamera.EnhancedOption;  | 1.21.5          | 직접 대체 없음     | 1.21.5       | Enhanced Camera가 기본 카메라로 설정되었기 때문에 깊이가 변경되었습니다.            |
| public get Speed(): number;                                                         | 1.21.5          | 직접 대체 없음     | 1.21.5       | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.                 |
| public get Sensitivity(): number;                                                   | 1.21.5          | 직접 대체 없음     | 1.21.5       | 더 이상 사용되지 않는 레거시 카메라의 속성이기 때문에 사용 중단되었습니다.                 |
| public get useEnhancedOption(): boolean;                                            | 1.21.5          | 직접 대체 없음     | 1.21.5       | Enhanced Camera가 기본 카메라로 설정되었기 때문에 항상 true를 반환하도록 변경되었습니다. |
| public SetCameraPosition()\:void;                                                   | 1.21.5          | 직접 대체 없음     | 1.21.5       | 사용성 및 안정성 문제로 제거되었습니다.                                     |
| public get LoadedRotateVector(): UnityEngine.Vector2;                               | -               | 직접 대체 없음     | 1.21.5       | 사용성 및 안정성 문제로 제거되었습니다.                                     |
| public get LoadedZoomDistance(): number;                                            | -               | 직접 대체 없음     | 1.21.5       | 사용성 및 안정성 문제로 제거되었습니다.                                     |
| public get viewportMargin(): number;<br />public set viewportMargin(value: number); | -               | 직접 대체 없음     | 1.21.6       | 사용성 및 안정성 문제로 제거되었습니다.                                     |

## 캐릭터 데이터

| **제거할 선언**                                    | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**                                                     |
| --------------------------------------------- | --------------- | ------------ | ------------ | ---------------------------------------------------------------- |
| public motionController: StateMachineVersion; | 1.21.5          | 직접적인 대체 없음   | -            | MotionController V1과 V2 사이에서 선택할 수 있는 옵션이 제거되었으며, 이제 사용 중단되었습니다. |



## 제페토 플레이어

| **제거할 선언**                               | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**           |
| ---------------------------------------- | --------------- | ------------ | ------------ | ---------------------- |
| public OnLoadedCharacter: System.Action; | -               | 직접적인 대체 없음   | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다. |
| public get isLoadedCharacter(): boolean; | -               | 직접적인 대체 없음   | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다. |
| public get id(): string;                 | -               | 직접적인 대체 없음   | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다. |



## 로컬 플레이어

| **제거할 선언**                                                                                                                                                       | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**           |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------ | ------------ | ---------------------- |
| public static Create($player: ZepetoPlayer, $zepetoCamera: ZepetoCamera, $playerControl: ZepetoPlayerControl, $cameraControl: ZepetoCameraControl)\:LocalPlayer; | -               | 직접적인 대체 없음   | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다. |



## 제페토 캐릭터

| **제거할 선언**                                                                                                                                | **버전에서 사용 중단됨** | **대신 사용할 것**  | **버전에서 제거됨** | **사용 중단 사유**                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------- | ------------ | ---------------------------------------------------------------- |
| public get MotionV2(): ZEPETO\_Character\_Controller\_StandardControl\_V2.MotionState;                                                    | 1.21.5          | `motionState` | -            | MotionController V1과 V2 사이에서 선택할 수 있는 옵션이 제거되었으며, 이제 사용 중단되었습니다. |
| public get StateMachineVersion(): StateMachineVersion;                                                                                    | 1.21.5          | 직접적인 대체 없음    | -            | MotionController V1과 V2 사이에서 선택할 수 있는 옵션이 제거되었으며, 이제 사용 중단되었습니다. |
| public static Create($hashCode: string, $metadata: Zepeto.ZepetoMetadata, $data: CharacterData, $spawnPoint: SpawnInfo)\:ZepetoCharacter; | -               | 직접적인 대체 없음    | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다.                                           |



## 캐릭터 상태 기계

| **제거할 선언**                                            | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**           |
| ----------------------------------------------------- | --------------- | ------------ | ------------ | ---------------------- |
| public Initialize($character: ZepetoCharacter)\:void; | -               | 직접적인 대체 없음   | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다. |



## 캐릭터 정보

| **제거할 선언**          | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**                      |
| ------------------- | --------------- | ------------ | ------------ | --------------------------------- |
| class CharacterInfo | -               | 직접적인 대체 없음   | 1.21.5       | CharacterInfo 클래스의 모든 타입이 제거되었습니다 |



## 설정

| **제거할 선언** | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**       |
| ---------- | --------------- | ------------ | ------------ | ------------------ |
| class 설정   | -               | 직접적인 대체 없음   | 1.21.5       | 전체 설정 클래스의 타입이 제거됨 |



## 열거형

| **제거할 선언**                                                         | **버전에서 사용 중단됨** | **대신 사용할 것** | **버전에서 제거됨** | **사용 중단 사유**           |
| ------------------------------------------------------------------ | --------------- | ------------ | ------------ | ---------------------- |
| enum PlayerControlMode \{ Default = 0, WalkOnly = 1, RunOnly = 2 } | -               | 직접적인 대체 없음   | 1.21.5       | 사용성 및 안정성 이유로 제거되었습니다. |



:::hint{type="info"}
**📘&#x20;**&#xB2E4;음 가이드를 참조하십시오. \[[ZEPETO.Character.Controller API](https://developer.zepeto.me/docs/character-controller/)]
:::

