《UnityAPI.CharacterController角色控制器》（Yanlz+Unity+SteamVR+云技术+5G+AI+VR云游戏+Unity+SimpleMove+立钻哥哥++OK++）

雨点打透心脏的1/2处 2022-12-02 01:09 101阅读 0赞

# **《UnityAPI.CharacterController角色控制器》** #

![20200828213849387.png][]

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="width:213.75pt;"> 版本 </td> 
 <td style="width:59.35pt;"> 作者 </td> 
 <td style="width:49.4pt;"> 参与者 </td> 
 <td style="width:63.75pt;"> 完成日期 </td> 
 <td style="width:39.85pt;"> 备注 </td> 
 </tr> 
 <tr> 
 <td style="width:213.75pt;"> UnityAPI_CharacterController_V01_1.0 </td> 
 <td style="width:59.35pt;"> 严立钻 </td> 
 <td style="width:49.4pt;"> &nbsp; </td> 
 <td style="width:63.75pt;"> 2020.08.28 </td> 
 <td style="width:39.85pt;"> &nbsp; </td> 
 </tr> 
 <tr> 
 <td style="width:213.75pt;"> &nbsp; </td> 
 <td style="width:59.35pt;"> &nbsp; </td> 
 <td style="width:49.4pt;"> &nbsp; </td> 
 <td style="width:63.75pt;"> &nbsp; </td> 
 <td style="width:39.85pt;"> &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

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

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

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">立钻哥哥：Unity是一个入门快、提高难的游戏引擎，想要提升能力，至少需要越过3道坎：API+Shader+综合能力；</h3> ++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也是一种先进技术的举例，也可以拓展至任何一种前沿技术； </td> 
 </tr> 
 </tbody> 
</table>

### **@@提示：**有些博客可能只是开了头，如果感兴趣的同学，可以“**点赞**”或“**评论区留言**”，只要关注的同学多了，那就会继续完善哟！（“**++==**”，表示没有写完的，如果关注度不高就不完善了；“**++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][https_blog.csdn.net_vrunsoftyanlz_category_7637520.html]

\++++**【Unity开发基础】分类：**[https://blog.csdn.net/vrunsoftyanlz/category\_7309057.html][https_blog.csdn.net_vrunsoftyanlz_category_7309057.html]

\++++**【Linux系统编程】分类：**[https://blog.csdn.net/vrunsoftyanlz/category\_9694767.html][https_blog.csdn.net_vrunsoftyanlz_category_9694767.html]

\++++**【C++C铸就生存利器】分类：**[https://blog.csdn.net/vrunsoftyanlz/category\_9325802.html][https_blog.csdn.net_vrunsoftyanlz_category_9325802.html]

\++++**【人工智能AI2026】分类：**[https://blog.csdn.net/vrunsoftyanlz/category\_9212024.html][https_blog.csdn.net_vrunsoftyanlz_category_9212024.html]

\++++**【立钻哥哥CSDN空间】：**[https://blog.csdn.net/VRunSoftYanlz/][https_blog.csdn.net_VRunSoftYanlz]

![20200828214028689.gif][]

![20200828214043273.gif][]

# **\#CharacterController角色控制器** #

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h1>#CharacterController角色控制器</h1> </td> 
 </tr> 
 </tbody> 
</table>

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2 style="margin-left:0pt;">#CharacterController角色控制器</h2> <h3 style="margin-left:0pt;">++A1、Description描述</h3> <h3 style="margin-left:0pt;">++B2、Variables变量</h3> <h3 style="margin-left:0pt;">++C3、Public Function共有函数</h3> <h3 style="margin-left:0pt;">++D4、Message消息</h3> </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 1][]

# **\#A1、Description描述** #

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h1>#A1、Description描述</h1> </td> 
 </tr> 
 </tbody> 
</table>

# **++A1、Description描述** #

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

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

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

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

### \++++**\[****Collider碰撞器****\]：**[https://blog.csdn.net/VRunSoftYanlz/article/details/106696886][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][https_blog.csdn.net_vrunsoftyanlz_category_7637520.html] ###

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

### \++++**\[UnityAPI目录\]：**[https://blog.csdn.net/VRunSoftYanlz/article/details/106533906][https_blog.csdn.net_VRunSoftYanlz_article_details_106533906] ###

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 3][]

![20200828214409109.gif][]

# **\#B2、Variables变量** #

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h1>#B2、Variables变量</h1> </td> 
 </tr> 
 </tbody> 
</table>

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2 style="margin-left:0pt;">++B2、Variables变量</h2> <h3 style="margin-left:0pt;">++++B2.1、center</h3> <h3 style="margin-left:0pt;">++++B2.2、collisionFlags</h3> <h3 style="margin-left:0pt;">++++B2.3、detectCollisions</h3> <h3 style="margin-left:0pt;">++++B2.4、height</h3> <h3 style="margin-left:0pt;">++++B2.5、isGrounded</h3> <h3 style="margin-left:0pt;">++++B2.6、radius</h3> <h3 style="margin-left:0pt;">++++B2.7、slopeLimit</h3> <h3 style="margin-left:0pt;">++++B2.8、stepOffset</h3> <h3 style="margin-left:0pt;">++++B2.9、velocity</h3> <h3 style="margin-left:0pt;">++++B2.10、YanlzXREngine.CharacterController.Variables</h3> </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 4][]

## **++B2.1、center** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.1、center</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.1、center** ##

### \++++立钻哥哥：**中心**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public Vector3 center;</h3> </td> 
 </tr> 
 </tbody> 
</table>

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

## **++B2.2、collisionFlags** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.2、collisionFlags</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.2、collisionFlags** ##

### \++++立钻哥哥：**碰撞标识**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public CollisionFlags collisionFlags;</h3> </td> 
 </tr> 
 </tbody> 
</table>

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

## **++B2.3、detectCollisions** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.3、detectCollisions</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.3、detectCollisions** ##

### \++++立钻哥哥：**检测碰撞**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public bool detectCollisions;</h3> </td> 
 </tr> 
 </tbody> 
</table>

\++++检测其他的刚体和角色控制器是否与本角色控制器相碰撞（默认值始终启用）；

\++++这个方法在角色控制器的运动期间不影响碰撞，决定当前控制器是否阻碍其他碰撞器；例如：场景中一个盒碰撞器将阻挡控制器的移动，但如果**detectCollisions**为**false**，盒子仍可以穿过控制器（并不是从身体穿过）；

## **++B2.4、height** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.4、height</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.4、height** ##

### \++++立钻哥哥：**高度**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public float height;</h3> </td> 
 </tr> 
 </tbody> 
</table>

\++++角色胶囊体的高度；

## **++B2.5、isGrounded** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.5、isGrounded</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.5、isGrounded** ##

### \++++立钻哥哥：**是否在地面上**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public bool isGrounded;</h3> </td> 
 </tr> 
 </tbody> 
</table>

\++++在最后一次移动角色控制器是否触碰地面？

## **++B2.6、radius** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.6、radius</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.6、radius** ##

### \++++立钻哥哥：**半径**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public float radius;</h3> </td> 
 </tr> 
 </tbody> 
</table>

\++++角色胶囊体的半径；

## **++B2.7、slopeLimit** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.7、slopeLimit</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.7、slopeLimit** ##

### \++++立钻哥哥：**坡度限制**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public float slopeLimit;</h3> </td> 
 </tr> 
 </tbody> 
</table>

\++++角色控制器的坡度度数限制；

## **++B2.8、stepOffset** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.8、stepOffset</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.8、stepOffset** ##

### \++++立钻哥哥：**台阶偏移量**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public float stepOffset;</h3> </td> 
 </tr> 
 </tbody> 
</table>

\++++以米为单位的角色控制器的台阶偏移量；

## **++B2.9、velocity** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++B2.9、velocity</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++B2.9、velocity** ##

### \++++立钻哥哥：**速度**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public Vector3 velocity;</h3> </td> 
 </tr> 
 </tbody> 
</table>

\++++角色当前的相对速度；

\++++**velocity**允许追踪角色实际走的有多快，例如：当他被卡在墙壁里，这个值将变为0向量；

\++++注意：返回速度在调用**CharacterController.Move**或者**CharacterController.SimpleMove**之前和之后的时刻是不同的；速度是相对的，因为它不会追踪发生在**CharacterController**之外的变换的运动（例如：角色继承于另一个运动着的变换之下，比如一个运动着的车辆）；

# **\#C3、Public Functions公有函数** #

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>#C3、Public Functions公有函数</h2> </td> 
 </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2 style="margin-left:0pt;">++C3、Public Functions公有函数</h2> <h3 style="margin-left:0pt;">++++C3.1、Move</h3> <h3 style="margin-left:0pt;">++++C3.2、SimpleMove</h3> <h3 style="margin-left:0pt;">++++C3.3、YanlzXREngine.CharacterController.PublicFunctions</h3> </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 5][]

## **++C3.1、Move** ##

## **++C3.1、Move** ##

### \++++立钻哥哥：**移动**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public CollisionFlags Move(Vector3 motion);</h3> </td> 
 </tr> 
 </tbody> 
</table>

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

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

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> using UnityEngine; using System.Collections; using YanlzXREngine; &nbsp; public class YanlzCharacterController : MonoBehaviour{ &nbsp;&nbsp;&nbsp; public float speed =&nbsp;6.0F; &nbsp;&nbsp;&nbsp; public float jumpSpeed = 8.0F; &nbsp;&nbsp;&nbsp; public float gravity = 20.0F; &nbsp;&nbsp;&nbsp; private Vector3 moveDirection = Vector3.zero; &nbsp; &nbsp;&nbsp;&nbsp; void Update(){ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; CharacterController controller = GetComponent&lt;CharacterController&gt;(); &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; if(controller.isGrounded){ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp;&nbsp; moveDirection = new Vector3(Input.GetAxis(“Horizontal”), 0, Input.GetAxis(“Vertical”)); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; moveDirection = transform.TransformDirection(moveDirection); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; moveDirection *= speed; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; if(Input.GetButton(“Jump”)){ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; moveDirection.y&nbsp;= jumpSpeed; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; } &nbsp;&nbsp;&nbsp;//立钻哥哥：if(){} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; } &nbsp;&nbsp;&nbsp;//立钻哥哥：if(controller.isGrounded){} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; moveDirection.y&nbsp;-= gravity *&nbsp;Time.deltaTime; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; controller.Move(moveDirection * Time.deltaTime); &nbsp; &nbsp;&nbsp;&nbsp; } &nbsp;&nbsp;&nbsp;//立钻哥哥：void Update(){} &nbsp; } &nbsp;&nbsp;&nbsp;//立钻哥哥：public class YanlzCharacterController{} </td> 
 </tr> 
 </tbody> 
</table>

## **++C3.2、SimpleMove** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++C3.2、SimpleMove</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++C3.2、SimpleMove** ##

### \++++立钻哥哥：**简单移动**； ###

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">public bool SimpleMove(Vector3 speed);</h3> </td> 
 </tr> 
 </tbody> 
</table>

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

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

# **\#D4、Message消息** #

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h1>#D4、Message消息</h1> </td> 
 </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2 style="margin-left:0pt;">++D4、Message消息</h2> <h3 style="margin-left:0pt;">++++D4.1、OnControllerColliderHit</h3> <h3 style="margin-left:0pt;">++++D4.2、YanlzXREngine.CharacterController.Message</h3> </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 6][]

## **++D4.1、OnControllerColliderHit** ##

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h2>++D4.1、OnControllerColliderHit</h2> </td> 
 </tr> 
 </tbody> 
</table>

## **++D4.1、OnControllerColliderHit** ##

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

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> <h3 style="margin-left:0pt;">CharacterController.OnControllerColliderHit(ControllerColliderHit hit);</h3> </td> 
 </tr> 
 </tbody> 
</table>

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

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

<table style="margin-left:5.65pt;"> 
 <tbody> 
 <tr> 
 <td style="width:415.3pt;"> using UnityEngine; using System.Collections; using YanlzXREngine; &nbsp; public class YanlzCharacterController : MonoBehaviour{ &nbsp;&nbsp;&nbsp; public float pushPower = 2.0F; &nbsp; &nbsp;&nbsp;&nbsp; void OnControllerColliderHit(ControllerColliderHit hit){ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Rigidbody body = hit.collider.attachedRigidbody; &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp; &nbsp; &nbsp;&nbsp; if(body == null ||&nbsp;body.isKinematic){ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; return; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; } &nbsp;&nbsp;&nbsp;//立钻哥哥：if(){} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; if(hit.moveDirection.y &lt; -0.3F){ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; return; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; } &nbsp;&nbsp;&nbsp;//立钻哥哥：if(){} &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Vector3 pushDir = new Vector3(hit.moveDirection.x, 0, hit.moveDirection.z); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; body.velocity = pushDir *&nbsp;pushPower; &nbsp; &nbsp;&nbsp;&nbsp; } &nbsp;&nbsp;&nbsp;//立钻哥哥：void OnControllerColliderHit(){} &nbsp; } &nbsp;&nbsp;&nbsp;//立钻哥哥：public class YanlzCharacterController{} </td> 
 </tr> 
 </tbody> 
</table>

![20200828214553995.gif][]

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

<table> 
 <tbody> 
 <tr> 
 <td style="width:426.1pt;"> <h1>#E5、立钻哥哥对CharacterController类的拓展</h1> </td> 
 </tr> 
 </tbody> 
</table>

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L1ZSdW5Tb2Z0WWFubHo_size_16_color_FFFFFF_t_70 7][]