版本

作者

参与者

完成日期

备注

UnityAPI_CharacterController_V01_1.0

严立钻

2020.08.28

立钻哥哥：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也是一种先进技术的举例，也可以拓展至任何一种前沿技术；

#CharacterController角色控制器

#CharacterController角色控制器

++A1、Description描述

++B2、Variables变量

++C3、Public Function共有函数

++D4、Message消息

#A1、Description描述

#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

++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;

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

public bool detectCollisions;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

    public CharacterController c;

    void MyTestFunc(){

        c = GetComponent<CharacterController>();

        c.detectCollisions = false;

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

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

++B2.4、height

public float height;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

    public CharacterController conteroller;

    void MyTestFunc(){

        controller = GetComponent<CharacterController>();

        controller.height = 2.0F;

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

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

++B2.5、isGrounded

public bool isGrounded;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

    void Update(){

        CharacterController controller = GetComponent<CharacterController>();

        if(controller.isGrounded){

            Debug.Log(“立钻哥哥：We are grounded.”);

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

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

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

++B2.6、radius

public float radius;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

    public CharacterController conteroller;

    void MyTestFunc(){

        controller = GetComponent<CharacterController>();

        controller.radius= 0.3F;

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

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

++B2.7、slopeLimit

public float slopeLimit;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

    public CharacterController conteroller;

    void MyTestFunc(){

        controller = GetComponent<CharacterController>();

        controller.slopeLimit = 45.0F;

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

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

++B2.8、stepOffset

public float stepOffset;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

    public CharacterController conteroller;

    void MyTestFunc(){

        controller = GetComponent<CharacterController>();

        controller.stepOffset = 2.0F;

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

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

++B2.9、velocity

public Vector3 velocity;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCharacterController : MonoBehaviour{

    void Update(){

        CharacterController controller = GetComponent<CharacterController>();

        Vector3 horizontalVelocity = controller.velocity;

        horizontalVelocity = new Vector3(controller.velocity.x, 0, controller.velocity.z);

        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

++C3.1、Move

public CollisionFlags Move(Vector3 motion);

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);

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

++D4.1、OnControllerColliderHit

CharacterController.OnControllerColliderHit(ControllerColliderHit hit);

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类的拓展

立钻哥哥推荐的拓展学习链接（Link_Url）