《UnityAPI.CharacterController角色控制器》

版本	作者	参与者	完成日期	备注
UnityAPI_CharacterController_V01_1.0	严立钻		2020.08.28

#《UnityAPI.CharacterController角色控制器》发布说明：

++++“UnityAPI.CharacterController角色控制器”是对UnityAPI中CharacterController角色控制器类的剖析和拓展；

立钻哥哥：Unity是一个入门快、提高难的游戏引擎，想要提升能力，至少需要越过3道坎：API+Shader+综合能力；

++1、API的积累：对API的合理利用不仅可以减轻自己的编码负担，而且往往可以提高程序的运行效率；这也是钻哥开始“Unity API”独立打造分类的初衷；

++2、Shader编程：想要做出一款精品游戏往往需要有高效的Shader的支持；Unity提供了一套改良的“Shader Lab”系统，优化了繁杂的“Open GL”编程；

++3、综合能力（技术+业务+管理）：一款产品的制作除了功能编程外，往往会涉及很多其他领域，例如产品架构、UI交互设计、模型制作等，作为主要的编程人员，对其他相关领域的了解程序往往会影响到产品制作直至最后的产品体验；

++++立钻哥哥一直在推动【VR云游戏=Unity+SteamVR+云技术+5G+AI】，这个只是一个引子，抛砖引玉让大家对整个知识体系有一个明确的落地方向，宝宝们可以根据自己的兴趣方向进行拓展：比如Unity这里是指一种“3D游戏引擎”，也可拓展至“UE4、Cocos2dx”等游戏引擎；SteamVR是一种跨硬件解决方案，也可拓展至“VRTK”等第三方插件；“云技术+5G”是一种跨平台解决方案的核心技术，同样可拓展至其他平台解决方案；AI也是一种先进技术的举例，也可以拓展至任何一种前沿技术；

@@提示：有些博客可能只是开了头，如果感兴趣的同学，可以“点赞”或“评论区留言”，只要关注的同学多了，那就会继续完善哟！（“++==”，表示没有写完的，如果关注度不高就不完善了；“++ok++”，表示此篇博客已经完成，是阶段性完整的！）

$$$$博客溯源：

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70

++++VR云游戏=Unity+SteamVR+云技术+5G+AI；（说明：AI人工智能不是我们的主要研究技术，只是了解一下，领略一下有风的感觉！但是，VR是我们的研究重点**）

++++【Unity API】分类：https://blog.csdn.net/vrunsoftyanlz/category_7637520.html

++++【Unity开发基础】分类：https://blog.csdn.net/vrunsoftyanlz/category_7309057.html

++++【Linux系统编程】分类：https://blog.csdn.net/vrunsoftyanlz/category_9694767.html

++++【C++C铸就生存利器】分类：https://blog.csdn.net/vrunsoftyanlz/category_9325802.html

++++【人工智能AI2026】分类：https://blog.csdn.net/vrunsoftyanlz/category_9212024.html

++++【立钻哥哥CSDN空间】：https://blog.csdn.net/VRunSoftYanlz/

#CharacterController角色控制器

++A1、Description描述

++B2、Variables变量

++C3、Public Function共有函数

++D4、Message消息

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 1

#A1、Description描述

++A1、Description描述

++++立钻哥哥：CharacterController（角色控制器）是让在受制于碰撞的情况下很容易地进行运动，而不用处理刚体；

++++[namespace]**：UnityEngine；

++++[Inherits from]**：Collider；

++++角色控制器不受力的影响，仅当调用Move函数时才运动；它执行运动，但是受制于碰撞；

++++[Collider碰撞器]：https://blog.csdn.net/VRunSoftYanlz/article/details/106696886

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 2

++++【Unity API】分类：https://blog.csdn.net/vrunsoftyanlz/category_7637520.html

++++[Unity快速入门]：https://blog.csdn.net/VRunSoftYanlz/article/details/105776475

++++[UnityAPI目录]：https://blog.csdn.net/VRunSoftYanlz/article/details/106533906

++++[**Application应用**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106086327

++++[**Object对象**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106202194

++++[**GameObject**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106223815

++++[**MonoBehaviour**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106533256

++++[**Component组件**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106367004

++++[**Transform变换**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106607761

++++[**Camera摄像机**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106148837

++++[**Shader着色器**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106321040

++++[**Material材质**]：https://blog.csdn.net/VRunSoftYanlz/article/details/81814303

++++[**Physics物理**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106268062

++++[**Collider碰撞器**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106696886

++++[**Rigidbody刚体**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106698042

++++[**Animator动画**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106863517

++++[**Animation**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106931626

++++[**AnimationCurve**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106952329

++++[**AnimationEvent**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107008468

++++[**Joint关节**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106771226

++++[**RaycastHit**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106292370

++++[**ParticleSystem**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106341995

++++[**WWW万维网**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106412890

++++[**LineRenerer**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106306388

++++[**WheelCollider**]：https://blog.csdn.net/VRunSoftYanlz/article/details/82356217

++++[**MovieTexture**]：https://blog.csdn.net/VRunSoftYanlz/article/details/106434063

++++[**Keyframe关键帧**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107008908

++++[**Debug调试**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107029574

++++[**Quaternion**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107271863

++++[**RectTransform**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107092732

++++[**Gizmos可视化**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107049986

++++[**LightProbes探测**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107372601

++++[**Ray射线**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107348830

++++[**Time时间**]：https://blog.csdn.net/VRunSoftYanlz/article/details/107325540

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 3

#B2、Variables变量

++B2、Variables变量

++++B2.1、center

++++B2.2、collisionFlags

++++B2.3、detectCollisions

++++B2.4、height

++++B2.5、isGrounded

++++B2.6、radius

++++B2.7、slopeLimit

++++B2.8、stepOffset

++++B2.9、velocity

++++B2.10、YanlzXREngine.CharacterController.Variables

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 4

++B2.1、center

++++立钻哥哥：中心；

public Vector3 center;

++++相对于变换位置的角色胶囊体的中心；

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

public CharacterController conteroller;

void MyTestFunc(){

controller = GetComponent<CharacterController>();

controller.center = new Vector3(0, 1, 0);

} //立钻哥哥：void MyTestFunc(){}

} //立钻哥哥：public class YanlzCharacterController{}

++B2.2、collisionFlags

++++立钻哥哥：碰撞标识；

public CollisionFlags collisionFlags;

++++在最后的CharacterController.Move调用期间，胶囊体的哪个部分与周围环境相碰撞；

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

void Update(){

CharacterController controller = GetComponent<CharacterController>();

if((controller.collisionFlags & CollisionFlags.Above) != 0){

Debug.Log(“立钻哥哥：touched the ceiling.”);

} //立钻哥哥：if(){}

} //立钻哥哥：void Update(){}

} //立钻哥哥：public class YanlzCharacterController{}

++B2.3、detectCollisions

float horizontalSpeed = horizontalVelocity.magnitude;

float verticalSpeed = controller.velocity.y;

float overallSpeed = controller.velocity.magnitude;

} //立钻哥哥：void Update(){}

} //立钻哥哥：public class YanlzCharacterController{}

#C3、Public Functions公有函数

++C3、Public Functions公有函数

++++C3.1、Move

++++C3.2、SimpleMove

++++C3.3、YanlzXREngine.CharacterController.PublicFunctions

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 5

++C3.1、Move

++++立钻哥哥：移动；

public CollisionFlags Move(Vector3 motion);

++++一个更加复杂的运动函数，采取绝对的运动增量；

++++尝试着通过motion移动控制器，motion只受限制于碰撞；Move将沿着碰撞器滑动；CollisionFlags是发生于Move的碰撞的概要；这个函数不应用任何重力；

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

public float speed = 6.0F;

public float jumpSpeed = 8.0F;

public float gravity = 20.0F;

private Vector3 moveDirection = Vector3.zero;

void Update(){

CharacterController controller = GetComponent<CharacterController>();

if(controller.isGrounded){

moveDirection = new Vector3(Input.GetAxis(“Horizontal”), 0, Input.GetAxis(“Vertical”));

moveDirection = transform.TransformDirection(moveDirection);

moveDirection = speed;

            if(Input.GetButton(“Jump”)){

                moveDirection.y = jumpSpeed;

            }    //立钻哥哥：if(){}

        }    //立钻哥哥：if(controller.isGrounded){}

moveDirection.y -= gravity Time.deltaTime;

controller.Move(moveDirection * Time.deltaTime);

} //立钻哥哥：void Update(){}

} //立钻哥哥：public class YanlzCharacterController{}

++C3.2、SimpleMove

++++立钻哥哥：简单移动；

public bool SimpleMove(Vector3 speed);

++++根据速度speed移动角色；

++++Y轴上速度被忽略；速度以米/秒为单位；重力被自动应用；返回如果角色着地；建议每帧只调用一次Move或者SimpleMove；

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

public float speed = 6.0F;

public float rotateSpeed = 3.0F;

void Update(){

CharacterController controller = GetComponent<CharacterController>();

transform.Rotate(0, Input.GetAxis(“Horizontal”) rotateSpeed, 0);

Vector3 forward = transform.TransformDirection(Vector3.forward);

float curSpeed = speed Input.GetAxis(“Vertical”);

controller.SimpleMove(forward * curSpeed);

} //立钻哥哥：void Update(){}

} //立钻哥哥：public class YanlzCharacterController{}

#D4、Message消息

++D4、Message消息

++++D4.1、OnControllerColliderHit

++++D4.2、YanlzXREngine.CharacterController.Message

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 6

++D4.1、OnControllerColliderHit

++++立钻哥哥：当控制器与碰撞器碰撞；

CharacterController.OnControllerColliderHit(ControllerColliderHit hit);

++++当角色控制器碰到一个可执行移动的碰撞器时，OnControllerColliderHit被调用；

++++这个可以被用于推动物体，当它们碰撞角色时；

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

public float pushPower = 2.0F;

void OnControllerColliderHit(ControllerColliderHit hit){

Rigidbody body = hit.collider.attachedRigidbody;

if(body == null || body.isKinematic){

return;

} //立钻哥哥：if(){}

if(hit.moveDirection.y < -0.3F){

return;

} //立钻哥哥：if(){}

Vector3 pushDir = new Vector3(hit.moveDirection.x, 0, hit.moveDirection.z);

body.velocity = pushDir * pushPower;

} //立钻哥哥：void OnControllerColliderHit(){}

} //立钻哥哥：public class YanlzCharacterController{}

#E5、立钻哥哥对CharacterController类的拓展

watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 7