Unity学习笔记——基础（贰）

this.gameObject.name // 名字
this.gameObject.activeSelf // 对象是否激活
this.gameObject.isSstatic // 对象是否静态
this.gameObject.layer // 层级
this.gameObject.tag // 标签
this.gameObject.transform // 对象变换组件

GameObject.CreatePrimitive(type); // 创建自带几何体
GameObject.Instantiate(original); // 实例化对象（克隆）
GameObject.Destroy(obj); // 销毁对象
GameObject.Destroy(obj , time); // 延迟销毁
GameObject.DestroyImmediate(obj); // 立即销毁
GameObject.DontDestroyOnLoad(obj); // 过场景不被销毁

GameObject.Find(name); // 在场景中查找对象
GameObject.FindGameObjectWithTag(tag); // 在场景中查找指定tag的对象
GameObject.FindGameObjectsWithTag(tag); // 在场景中查找指定tag的多个对象
GameObject.FindObjectsOfType<T>(); // 在场景中查找指定类型的对象（属于Object类的方法）

this.gameObject.AddComponent<T>(); // 添加脚本
this.gameObject.GetComponent<T>(); // 获取脚本
this.gameObject.CompareTag(tag); // 对比标签（等价：this.gameObject.tag == tagName;）
this.gameObject.SetActive(value); // 设置对象激活状态

this.gameObject.SendMessage(methodName); // 执行对象上指定名称的方法（在对象所有脚本中寻找）
this.gameObject.BroadcastMessage(methodName); // 执行自己和子对象的指定名方法
this.gameObject.SendMessageUpwards(methodName); // 执行自己和父对象的指定名方法

Time.timeScale; // 时间缩放比例
Time.deltaTime; // 帧间隔时间
Time.unscaledDeltaTime; // 帧间隔时间，不受timeScale影响
Time.time // 游戏从开始到现在的时间
Time.unscaledtime // 游戏从开始到现在的时间，不受timeScale影响
Time.fixedDeltaTime // 物理帧间隔时间
Time.fixedUnscaledDeltaTime // 物理帧间隔时间，不受timeScale影响
Time.frameCount // 从游戏开始到现在跑了多少帧

Vector3.zero; // 零坐标
Vector3.right; // 世界坐标正右方
Vector3.left; // 世界坐标正左方
Vector3.forward; // 世界坐标正前方
Vector3.back; // 世界坐标正后方
Vector3.up; // 世界坐标正上方
Vector3.down; // 世界坐标正下方

vec.magnitude; // 向量模长
vec.normalized; // 单位向量

Vector3.Distance(a，b); // 计算两点间的距离
Vector3.Dot(a, b); // 点乘
Vector3.Angle(a, b); // 计算两个向量间的夹角
Vector3.Cross(a, b); // 叉乘
Vector3.Lerp(start, end, t); // 线性插值
Vector3.Slerp(start, end, t); // 球形插值

this.transform.position; // 世界坐标位置
this.transform.localPosition; // 本地坐标位置
this.transform.eulerAngles; // 欧拉角
this.transform.localEulerAngles // 本地坐标的欧拉角
this.transform.lossyScale; // 缩放
this.transform.localScale; // 本地坐标的缩放

this.transform.forward; // 物体正前方
this.transform.up; // 物体正上方
this.transform.right; // 物体正右方

this.transform.Translate(translation, relativeTo); // 朝指定方向和距离移动。参数2表示相对坐标系，默认为self
this.transform.Rotate(eulers, relativeTo); // 绕指定轴旋转
this.transform.Rotate(axis, angle, relativeTo); // 绕指定轴旋转（重载）
this.transform.RotateAround(point, axis, angle); // 绕某个点的指定轴旋转
this.transform.LookAt(target); // 看向某个对象
this.transform.LookAt(worldPosition); // 看向某个点

transform.Translate(Vector3.forward * Time.deltaTime, Space.World); // 始终向世界坐标Z轴正方向移动
transform.Translate(transform.forward * Time.deltaTime, Space.World); // 始终朝物体正前方移动
transform.Translate(Vector3.forward * Time.deltaTime, Space.Self); // 始终朝物体正前方移动
transform.Translate(transform.forward * Time.deltaTime, Space.Self); // 不推荐使用，自身坐标系下，transform.forward会导致重复计算，导致方向错误

this.transform.parent; // 父对象
this.transform.childCount; // 子对象数量

this.transform.SetParent(parent，worldPositionStays); // 设置父对象。参数2表示是否保持原本的世界坐标位置不动
this.transform.DetachChildren(); // 与子对象断开父子关系
this.transform.Find(name); // 找到子对象（可以找到失活对象,通过"/"号分隔可以找到子对象的子对象）
this.transform.GetChild(index); // 通过索引获取子对象
this.transform.IsChildOf(parent); // 判断是否是parent的子对象
this.transform.GetSiblingIndex(); // 获取作为子对象的索引
this.transform.SetAsFirstSibling(); // 设置为第一个子对象
this.transform.SetAsLastSibling(); // 设置为最后一个子对象
this.transform.SetSiblingIndex(索引); // 设置自己的位置

Debug.Log(message); // 打印信息
Debug.LogError(message); // 打印错误信息
Debug.LogWarning(message); // 打印警告信息
Debug.DrawLine(start, end, color, duration); // 调试画线
Debug.DrawRay(start, dir, color, duration); // 调试发射射线

Input.GetKeyDown(keyCode); // 键盘按下
Input.GetKeyUp(keyCode); // 键盘抬起
Input.GetKey(keyCode); // 键盘长按

Input.mousePosition; // 鼠标位置（屏幕坐标系）
Input.mouseScrollDelta； // 鼠标滚轮滚动（-1往下滚，1往上滚）

Input.GetMouseButtonDown(button); // 鼠标按下
Input.GetMouseButtonUp(button); // 鼠标抬起
Input.GetMouseButton(button); // 鼠标长按

Input.anyKey; // 是否有任意键或鼠标长按
Input.anyKeyDown; // 是否有任意键或鼠标按下

Input.GetAxis(axisName); // 获取某个键的值
Input.GetAxisRaw(axisName); // 获取某个键的值（只有-1、0、1三个固定值）

Cursor.visible; // 鼠标是否可见
Cursor.lockState; // 锁定鼠标状态
Cursor.SetCursor(texture, hotspot, cursorMode); // 设置鼠标图片（参数：图片，偏移位置，光标模式）

Screen.currentResolution; // 获取当前屏幕分辨率
Screen.width; // 获取屏幕窗口当前宽
Screen.height; // 获取屏幕窗口当前高
Screen.SetResolution(width，height，fullscreen); // 设置分辨率

Screen.sleepTimeout; // 屏幕休眠模式
Screen.fullScreen; // 运行时是否全屏模式
Screen.fullScreenMode; // 全屏模式

FullScreenMode.ExclusiveFullScreen; // 独占全屏
FullScreenMode.FullScreenWindow; // 全屏窗口
FullScreenMode.MaximizedWindow; // 最大化窗口
FullScreenMode.Windowed; // 窗口模式

Screen.autorotateToLandscapeLeft; // 是否允许手机自动旋转为左横向，Home在左
Screen.autorotateToLandscapeRight; // 是否允许手机自动旋转为右横向，Home在右
Screen.autorotateToPortrait; // 是否允许手机自动旋转为纵向，Home在下
Screen.autorotateToPortraitUpsideDown; // 是否允许手机自动旋转为纵向，Home在上

Camera.main // 获取主摄像机
Camera.allCamerasCount // 获取摄像机数量
Camera.allCameras // 得到所有摄像机

Camera.onPreCull; // 摄像机剔除前处理
Camera.onPreRender; // 摄像机渲染前处理
Camera.onPostRender; // 摄像机渲染后处理

rigidbody.velocity; // 速度

rigidbody.AddForce(force); // 添加力（世界坐标）
rigidbody.AddRelativeForce(force); // 添加力（本地坐标）
rigidbody.AddTorque(torque); // 添加扭矩力（世界坐标）
rigidbody.AddRelativeTorque(torque); // 添加扭矩力（本地坐标）
rigidbody.AddExplosionForce(force, position, radius); // 添加爆炸的力

ForceMode.Acceleration; // 给物体施加一个持续的加速度，忽略物体质量
ForceMode.Force; // 给物体施加一个持续的力，与物体质量相关
ForceMode.Impulse; // 给物体施加一个瞬间的力，与物体质量相关
ForceMode.VelocityChange; // 直接给物体设置一个瞬时速度，忽略质量和作用时间

if (rigidBody.IsSleeping()) // 刚体是否处于休眠状态
{
    rigidBody.WakeUp(); // 唤醒刚体，让它重新参与物理计算
}

private void OnCollisionEnter(Collision collision)
{
    collision.collider; // 获取碰撞到的对象的碰撞器
    collision.gameObject; // 获取碰撞对象的GameObject
    collision.transform; // 获取碰撞对象的Transform组件
    collision.contactCount; // 获取碰撞接触点的数量
    collision.contacts; // 获取所有接触点的坐标数组
    collision.GetContact(index); // 获取位于指定index处的接触点
}

private void OnTriggerEnter(Collider other)
{
    other.enabled; // 开启/关闭这个碰撞体
    other.gameObject; // 获取碰撞体所在的GameObject
    other.transform; // 获取碰撞体所在物体的Transform组件
    other.bounds; // 获取碰撞体的包围盒
    other.isTrigger; // 是否是触发器
    other.ClosestPoint(worldPos); // 碰撞体上离worldPos最近的点
    other.ClosestPointOnBounds(worldPos); // 碰撞体的包围盒上离worldPos最近的点
    other.Raycast(ray, out hitInfo, maxDistance); // 判断射线能不能射到当前这个物体
}

audioSource.Play(); // 播放
audioSource.Stop(); // 停止
audioSource.Pause(); // 暂停
audioSource.PlayDelayed(); // 延迟播放
audioSource.UnPause(); // 接触暂停
audioSource.isPlaying; // 是否播放完毕

clip.channels; // 声道数
clip.samples; // 单声道的采样总数（剪辑长度）
float[] data = new float[clip.channels * clip.samples]; // 得到音频数据的float数组大小
clip.GetData(data, offset); // 将clip从offset位置开始的音频数据，读取到data数组中

Microphone.devices; // 获取所有麦克风信息
Microphone.Start(deviceName, loop, lengthSec, frequency); // 开始录制音频（参数：设备名，是否循环，录制时长，频率）
Microphone.End(deviceName); // 停止录制

Mathf.Abs(value); // 绝对值
Mathf.CeilToInt(value); // 向上取整
Mathf.FloorToInt(value); // 向下取整
Mathf.Clamp(value, min, max); // 钳制函数,限制数的范围
Mathf.Max(a, b); // 最大值
Mathf.Min(a, b); // 最小值
Mathf.Pow(value，pow); // 幂函数
Mathf.RoundToInt(value); // 四舍五入
Mathf.Sqrt(value); // 平方根
Mathf.IsPowerOfTwo(value); // 判断一个数是否是2的n次方
Mathf.Sign(value); // 判断正负数(正数1，负数-1）

Mathf.PI; // PI的值
Mathf.Deg2Rad; // 角度转弧度（角度 * Mathf.Deg2Rad = 对应弧度）
Mathf.Rad2Deg; // 弧度转角度（弧度 * Mathf.Rad2Deg = 对应角度）
Mathf.Sin(value); // 正弦
Mathf.Cos(value); // 余弦
Mathf.ASin(value); // 反正弦
Mathf.ACos(value); // 反余弦

Mathf.Lerp(start, end, t); // 插值运算

this.transform.InverseTransformPoint(Vector); // 世界坐标点转本地坐标（受缩放影响）
this.transform.InverseTransformDirection(Vector); // 世界坐标向量转本地坐标（不受缩放影响）
this.transform.InverseTransformVector(Vector); // 世界坐标向量转本地坐标（受缩放影响）
this.transform.TransformPoint(Vector); // 本地坐标点转世界坐标（受缩放影响）
this.transform.TransformDirection(Vector); // 本地坐标向量转世界坐标（不受缩放影响）
this.transform.TransformVector(Vector); // 本地坐标向量转世界坐标（受缩放影响）

Camera.main.WorldToScreenPoint(position) // 世界坐标转屏幕坐标（转换后z轴表示离摄像机多远）
Camera.main.ScreenToWorldPoint(position) // 屏幕坐标转世界坐标（参数的z轴表示离摄像机多远）

Camera.main.WorldToViewportPoint(position); // 世界坐标转视口坐标
Camera.main.ViewportToWorldPoint(position); // 视口坐标转世界坐标

Camera.main.ViewportToScreenPoint(position); // 视口坐标转屏幕坐标
Camera.main.ScreenToViewportPoint(position); // 屏幕坐标转视口坐标

Quaternion q = new Quaternion(x, y, z, w); // 构造函数
Quaternion q = Quaternion.AngleAxis(angle, axis); // 轴角对
Quaternion.identity; // 单位四元数

q.eulerAngles; // 四元数转欧拉角
Quaternion.Euler(x, y, z); // 欧拉角转四元数

Quaternion.Lerp(a, b, t); // 线性插值
Quaternion.Slerp(a, b, t); // 球形插值

Quaternion.LookRotation(forward); // 面向forward所指方向

IEnumerator Func()
{
    yield return null; // 下一帧执行
    yield return 0; // 任意数字均可，在下一帧执行
    yield return new WaitForSeconds(seconds); // 等待指定秒
    yield return new WaitForFixedUpdate(); // 等待下一个物理帧更新时执行
    yield return new WaitForEndOfFrame(); // 等待LateUpdate后的渲染相关处理完毕后
    yield return new WaitUntil(predicate); // 一直等待，直到委托为true时继续往下执行
    yield break; // 跳出协程
}

StartCoroutine(routine); // 开启协程
StopCoroutine(routine); // 关闭协程
StopAllCoroutines(); // 关闭所有协程

Resources.Load(path); // 同步加载单个资源
Resources.Load<T>(path); // 同步加载单个资源
Resources.LoadAll(path); // 同步加载所有资源

ResourceRequest rq = Resources.LoadAsync<T>(path);  // 异步加载单个资源
rq.completed += Func; // 添加资源加载完成后的回调函数

// 可配合协程进行异步加载
rq.isDone; // 是否加载完成
rq.priority; // 进度
rq.asset; // 资源

IEnumerator Load()
{
    ResourceRequest rq = Resources.LoadAsync<T>(path);
    
    // 使用yield return
    yield return rq; // 等待资源加载完毕再执行
    
	// 或者使用while判断
    while (!rq.isDone)
    {
        Debug.Log(rq.progress); // 打印进度
        yield return null;
    }
    
    rq.asset; // 获取资源
}

Resources.UnloadAsset(assetToUnload); // 卸载指定资源
Resources.UnloadUnusedAssets(); // 卸载未使用资源

SceneManager.LoadScene(sceneName, mode); // 同步加载场景

AsyncOperation ao = SceneManager.LoadSceneAsync(sceneName); // 异步加载场景
ao.completed += Func; // 场景加载完后的委托

IEnumerator Load()
{
    AsyncOperation ao = SceneManager.LoadSceneAsync(sceneName);
    
    // 使用 yield return
    yield return ao; // 等待场景加载完毕再执行
    
    // 或者使用while判断
    while (!ao.isDone)
    {
        Debug.Log(ao.progress); // 打印进度
        yield return null;
    }
    
    // 重要属性：加载完是否自动切换场景
    // 设为false，则 progress = 0.9 会停下，需设置为true才可以切换场景
    ao.allowSceneActivation;
}

lineRenderer.loop; // 是否首尾相连（闭合线段）
lineRenderer.startWidth; // 设置线段起点宽度
lineRenderer.endWidth; // 设置线段终点宽度
lineRenderer.startColor; // 设置线段起点颜色
lineRenderer.endColor; // 设置线段终点颜色
lineRenderer.material; // 设置材质

lineRenderer.positionCount; // 设置线段点个数
lineRenderer.SetPositions(positions); // 一次性设置所有点
lineRenderer.SetPosition(index, position); // 单独设置某个点的位置
lineRenderer.useWorldSpace = false; // 是否使用世界坐标系（false为局部坐标系）
lineRenderer.generateLightingData = true; // 是否让线段受光照影响（接受光照数据参与着色器计算）

 // 盒状范围检测
Physics.OverlapBox(center, size, orientation, layerMask, queryTriggerInteraction); // 参数5表示是否忽略触发器
Physics.OverlapBoxNonAlloc(center, size, results); // NonAlloc，不产生GC，返回碰撞的数量

 // 球体范围检测
 Physics.OverlapSphere(...);
 Physics.OverlapSphereNonAlloc(...);

 // 胶囊体范围检测
 Physics.OverlapCapsule(...);
 Physics.OverlapCapsuleNonAlloc(...);

// 获取射线
Ray ray = new Ray(origin, direction); // 声明射线
Ray ray = Camera.main.ScreenPointToRay(pos); // 摄像机屏幕点发出的射线

Physics.Raycast(ray, maxDistance, layerMask, queryTriggerInteraction); // 检测射线是否碰撞到了对象
Physics.Raycast(origin, direction, maxDistance, layerMask, queryTriggerInteraction); // 检测射线是否碰撞到了对象（重载）

Physics.Raycast(ray, out hitInfo, maxDistance, layerMask,queryTriggerInteraction); // 获取检测到的单个对象信息
Physics.RaycastAll(ray, maxDistance, layerMask, queryTriggerInteraction); // 获取检测到的多个对象
Physics.RaycastNonAlloc(ray, results, maxDistance, layerMask); // 获取碰撞对象的数量（NonAlloc版本，不产生GC）

hitInfo.collider.gameObject; // 碰撞的物体
hitInfo.point; //  碰撞点
hitInfo.normal; // 碰撞面的法线
hitInfo.transform; // 碰撞物体的变换信息
hitInfo.distance; // 射线起点到碰撞点的距离

LayerMask.GetMask(layerNames); // 可以方便的获取多个层级
1 << LayerMask.NameToLayer("Monster"); // 若是多个层级，可以使用或运算 |