--- title: ZEPETO.Character.Controller - 弃用声明 slug: world-sdk-guide-ch/zepetocharactercontroller 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\)\: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 | 没有直接替代品 | - | 深度已更改，因为增强相机已被设置为默认相机。 | ## Zepeto相机 | **要删除的声明** | **在版本中已弃用** | **替代使用的内容** | **在版本中已删除** | **弃用原因** | | ----------------------------------------------------------------------------------- | ----------- | ----------- | ----------- | ----------------------------- | | 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 | 深度已更改，因为增强相机已设置为默认相机。 | | 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 | 增强相机已设置为默认相机，因此它已更改为始终返回true。 | | public SetCameraPosition()\:void; | 1.21.5 | 没有直接替代品 | 1.21.5 | 它已被弃用，因为它是一个不再使用的旧版相机的属性。 | | public UpdateFollow($deltaTime: number)\:void; | - | 没有直接替代品 | 1.21.5 | 它因可用性和稳定性原因而被删除。 | | public get LoadedRotateVector(): UnityEngine.Vector2; | - | 没有直接替代品 | 1.21.5 | 它因可用性和稳定性原因而被删除。 | | public get LoadedZoomDistance(): number; | - | 没有直接替代品 | 1.21.5 | 它因可用性和稳定性原因而被删除。 | | public get viewportMargin(): number;
public set viewportMargin(value: number); | - | 没有直接替代品 | 1.21.6 | 它因可用性和稳定性原因而被删除。 | ## 字符数据 | **要删除的声明** | **在版本中已弃用** | **替代使用的内容** | **在版本中已删除** | **弃用原因** | | --------------------------------------------- | ----------- | ----------- | ----------- | --------------------------------------- | | public motionController: StateMachineVersion; | 1.21.5 | 没有直接替代品 | - | 已删除选择MotionController V1和V2的选项，并且现在已弃用。 | ## Zepeto玩家 | **要删除的声明** | **在版本中已弃用** | **替代方案** | **在版本中已删除** | **弃用原因** | | ---------------------------------------- | ----------- | -------- | ----------- | -------------- | | 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 | 由于可用性和稳定性原因已被删除。 | ## Zepeto角色 | **要删除的声明** | **在版本中已弃用** | **替代使用的内容** | **在版本中已删除** | **弃用原因** | | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------- | ----------- | ---------------------------------------- | | 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 | 由于可用性和稳定性原因已被删除。 | ## 角色信息 | **要删除的声明** | **在版本中已弃用** | **替代使用的内容** | **在版本中已删除** | **弃用原因** | | --------------- | ----------- | ----------- | ----------- | ------------------------ | | 类 CharacterInfo | - | 没有直接替代品 | 1.21.5 | 整个 CharacterInfo 类已移除其类型 | ## 设置 | **要删除的声明** | **在版本中已弃用** | **替代使用的内容** | **在版本中已删除** | **弃用原因** | | ---------- | ----------- | ----------- | ----------- | ------------ | | 类设置 | - | 没有直接替代品 | 1.21.5 | 整个设置类的类型已被移除 | ## 枚举 | **要删除的声明** | **在版本中弃用** | **替代使用的内容** | **在版本中删除** | **弃用原因** | | -------------------------------------------------- | ---------- | ----------- | ---------- | --------------- | | 枚举 PlayerControlMode \{ 默认 = 0, 仅步行 = 1, 仅跑步 = 2 } | - | 没有直接替代品 | 1.21.5 | 由于可用性和稳定性原因被删除。 | :::hint{type="info"} **📘 **请参考以下指南。 \[[ZEPETO.Character.Controller API](https://developer.zepeto.me/docs/character-controller/)] :::