【Unity】常用API和功能

前言

持续更新中..

目标阅读者：Unity新手项目程序员

简单的前置：编程习惯

Unity常用API

按键Input
旧版Input

void Update(){if (Input.GetKey("up")){print("up arrow key is held");}if (Input.GetKeyDown("down")){print("down arrow key is held down");}       if (Input.GetMouseButton(0)){print("鼠标左键点击");} }

OnGUI

void OnGUI(){if (GUI.Button(new Rect(10, 10, 150, 100), "I am a button")){            }}

Log

/*正常Log*/
Debug.Log("<color=#9400D3> You clicked the button! </color>");
/*跳转到GameObject*/
Debug.Log(Obj,"跳转");/*颜色*/
//green 绿色  #008000ff    red 红色 #ff0000ff
//white 白色  #ffffffff    yellow 黄色  #ffff00ff/*转义符*/
\’   单引号符
\”  单引号符
\\  反斜线符"\"
\n  换行
\r  回车
text在运行后\会自动变成了\\,所以无效解决方法:
msgText.text = msg.Replace("\\n", "\n");

发布pc日志路径
Windows C:\Users\username\AppData\LocalLow\CompanyName\ProductName\Player.log
或者
Windows C:\Users\username\AppData\LocalLow\CompanyName\ProductName\output_log.txt

发布的时候勾选development build的unity游戏和常规build有两方面不同：development build在游戏运行时可以连接profiler，并且包含了调试用的文件。
取消发布log消耗

移动与旋转

//-------------旋转------------ //
//设置角度     (超过90°或负数时，会设置-1结果是359这样的问题，可以使用下面旋转的方式)
transform.rotate = new Quaternion(0,0,0,0);//Quaternion四元数
transform.localEulerAngles = new Vector3(0,0,0);//EulerAngles欧拉角//旋转
transform.rotation = Quaternion.AngleAxis(30, Vector3.up);//绕轴旋转Quaternion正方向30
transform.Rotate(new Vector3(20 * Time.dealtime, 0, 0));//旋转XYZ
transform.RotateAround(Vector3.zero, Vector3.up, 50 * Time.dealtime);//绕点旋转//四元数与欧拉角转换
Quaternion quaternoin= Quaternion.Euler(vector3);
Vector3 rotation = Quaternion.EulerAngles(quaternoin);//旋转向量
targetVector = quaternion * origVector;
var destDir = Quaternion.Euler(0, angle, 0) * Transform.forward;//获取角度  不能获取正负，暂没找到方法
Vector3 rotation = Obj.transform.localEulerAngles;//-----------3D位移---------- //
//方向
transform.Translate(Vector3.back * FallingSpeed);
transform.position = Vector3.MoveTowards(transform.position,tempUpdatePos, Time.deltaTime * DisShakeThreshold);
//固定时间
transform.Translate(Vector3.normalize(tarPos-selfPos) *(Vector3.Distance(selfPos,tarPos)/(setTime * Time.deltime)));//-----------2D方向移动---------- //
moveDirection = mTarget.transform.position - mSelf.transform.position;
moveDirection.Normalize();
float target = Mathf.Atan2(moveDirection.y, moveDirection.x) * Mathf.Rad2Deg - 90f;
mSelf.transform.rotation =
Quaternion.Slerp(mSelf.transform.rotation,
Quaternion.Euler(0, 0, target), turnSpeed * Time.deltaTime);
_controller.SetForce(speedX,speedY));

DOTween

显示模式分为：
Center状态：按照计算GameObject的中心
Pivot状态：GameObject的时机位置

夹角
```
Vector3.Angle(form, to)
```
Animator/Animation
Animator结构
Animator(组件)→runtimeAnimator(*.controller)→Layer→State→Animation Clips(*.anim)
Unity 从Animator组件中获得AnimationClip(editor工具不用new)
animator.update()可以保证更新一致(lockstep用)

Animator可以被继承!
Animator可以添加脚本处理状态!

RootMontion
可以使用RootMotion达到美术想要的移动，如果要逻辑表现分离，那么可以导出数据

AnimationEvent
在Clip上可以直接打事件,事件会获取所有Component的所有Public方法
也可以使用AnimationEvent作为参数

获取某个动画名字的时间长度
```
void GetLengthByName(string name)
{AnimationClip[] clips = animator.runtimeAnimatorController.animationClips;foreach(AnimationClip clip in clips)    {if(clip.name.Equals(name))        {float length = clip.length;            break;}}
}
```
重置动画(播放动画第一帧)
```
firstAnimName = GetComponent<Animator>().GetCurrentAnimatorClipInfo(0)[0].clip.name;
GetComponent<Animator>().Play (firstAnimName,-1,0); 
```
Animation组件
如果使用Animation组件,clip的设置需要先打卡锁旁边的设置为debug,然后勾选legacy
animation不能播放ui.image的序列帧动画
baseonrenderes在屏幕外结束的动画,再次播放会被裁剪..

AnimationEvent
在第0帧和末尾真可能会不触发，
据测试，BlendTree是但凡有一点都会触发，完全没有则不会触发。

资源加载和创建删除
资源加载
主要分为三种
①Resources -- 文件夹内的加载(不要使用这个唯一使用情况是小项目和测试)
②UnityEditor.AssetDatabase -- Editor的加载，也是为了Editor快速测试，同时兼容能保持打ab包的项目资源存放格式
③AssetBundle -- 可以热更，可以分包，项目基本必须用这个
//作为重要功能深入研究会发现坑很多→详细解析

/************创建****************/
/*********Resource文件夹*********/
/*同步加载*/
GameObject prefab = Resources.Load("资源路径/名字") as GameObject;
/*异步加载*/
GameObject prefab2 = Resources.LoadAsync<Object>(path);
/*实例化*/
GameObject go = Instantiate(prefab) as GameObject;/*************非Resourece**************/
//路径为 Assets/XX/XX.prefab 这样的格式
UnityEditor.AssetDatabase.LoadAssetAtPath<T>(path);/**************AssetBundle**************/
AssetBundle bundle = AssetBundle.LoadFromFile(path);
Object obj = bundle.LoadAsset<GameObject>("XXXX");/******************删除****************/
//非AB
GameObject.Destroy(go);//下一帧删除
GameObject.DestroyImmediate(go);//马上删除//AB
Destroy UnloadAB(true)
如果没清除依赖UnloadUnUseAsset然后GC

Destory的坑:会before删除

物理碰撞

Edit-Project Settings-Physics
打开物理管理器（Physics Manager）里面可以设置层级相互间的碰撞
碰撞条件是都带Collider 其中一个带rigidbody

//触发器
MonoBehaviour.OnTriggerEnter(Collider collider)当进入触发器
MonoBehaviour.OnTriggerExit(Collider collider)当退出触发器
MonoBehaviour.OnTriggerStay(Collider collider)当逗留触发器//碰撞信息检测：
MonoBehaviour.OnCollisionEnter(Collision collision) 当进入碰撞器
MonoBehaviour.OnCollisionExit(Collision collision) 当退出碰撞器
MonoBehaviour.OnCollisionStay(Collision collision)  当逗留碰撞器

射线射碰撞体与层

//(检测是否碰撞)
//parameter1:origin起始位置
//parameter2:世界方向
//parameter3:长度
//parameter4:检测的层
if (Physics.Raycast(origin, Vector3.down, 1f,1 << LayerMask.NameToLayer("Ground")))
{//层的说明//int 1-31是未转化的层index 而用于射线LayerMask 是1<<int 运算后的 是一个很大的数// 1 << 10 打开第10的层。 等价于 1 << LayerMask.NameToLayer("Ground");//~(1 << 10) 打开除了第10之外的层。//~(1 << 0) 打开所有的层。//(1 << 10) | (1 << 8) 打开第10和第8的层。等价于 LayerMask.GetMask(("Ground", "Wall");
}
//(输出信息的)
Ray ray = new Ray(transform.position, Vector3.down);
RaycastHit hitInfo = new RaycastHit();
if (Physics.Raycast(ray, out hitInfo, 30f, layerMask))Debug.Log(hitInfo.point);//物体
gameObject.layer = (1-31层 或 LayerMask.NameToLayer("Ground"));
//发射碰撞体
Physics.OverXXX
//一些问题
//射线无法检查到起点边缘的物体

在Unity中每个GameObject都有Layer属性，默认的Layer都是Default。在Unity中可编辑的Layer共有24个（8—31层），官方已使用的是0—7层，默认不可编辑！

LayerMask实际上是一个位码操作，在Unity3D中一共有32个Layer层，并且不可增加。

位运算符
按位运算符：~、|、&、^。位运算符主要用来对二进制位进行操作。

逻辑运算符：&&、||、！。逻辑运算符把语句连接成更复杂的复杂语句。

按位运算符：左移运算符<<，左移表示乘以2，左移多少位表示乘以2的几次幂。

刚体
Mass:质量(kg)
Drag:空气阻力越大越难推动
Angular Drag:旋转阻力越大越不会旋转 0无阻力 10以后基本无惯性
Use Gravity:是否使用重力

Constraints
Freeze Position:锁定位置
Freeze Rotation:锁定旋转

GameObject

//获取自己index
int id = self.GetSiblingIndex();

协程IEnumerator

void Start(){StartCoroutine(Test());
}
IEnumerator Test()
{yield return null; // 下一帧再执行后续代码yield return 0; //下一帧再执行后续代码yield return 6;//(任意数字) 下一帧再执行后续代码yield break; //直接结束该协程的后续操作yield return asyncOperation;//等异步操作结束后再执行后续代码yield return StartCoroution(/*某个协程*/);//等待某个协程执行完毕后再执行后续代码yield return WWW();//等待WWW操作完成后再执行后续代码yield return new WaitForEndOfFrame();//等待帧结束,等待直到所有的摄像机和GUI被渲染完成后，在该帧显示在屏幕之前执行yield return new WaitForSeconds(0.3f);//等待0.3秒，一段指定的时间延迟之后继续执行，在所有的Update函数完成调用的那一帧之后（这里的时间会受到Time.timeScale的影响）;yield return new WaitForSecondsRealtime(0.3f);//等待0.3秒，一段指定的时间延迟之后继续执行，在所有的Update函数完成调用的那一帧之后（这里的时间不受到Time.timeScale的影响）;yield return WaitForFixedUpdate();//等待下一次FixedUpdate开始时再执行后续代码yield return new WaitUntil()//将协同执行直到 当输入的参数（或者委托）为true的时候....如:yield return new WaitUntil(() => frame >= 10);yield return new WaitWhile()//将协同执行直到 当输入的参数（或者委托）为false的时候.... 如:yield return new WaitWhile(() => frame < 10);
}

想使用协程如果没有继承mono 那可以使用一个继承mono的去做
当代码不依赖mono而又想使用协程那么可以使用这个工具
每当这个工具被调用是创建一个新的GameObject去启动任务IEnumerate的Func
因为当需要停止的时候虽然mono有stop的方法但是对于同名的函数就没有办法了,所以每次调用都会创建go

    public class CoroutineComponent : Component{public static CoroutineComponent Instance { get; private set; }public delegate System.Collections.IEnumerator CoroutineFunc();private GameObject root;private Dictionary<CoroutineFunc, GameObject> dicFunc2Object;public void Awake(){Instance = this;root = new GameObject("CoroutineRoot");root.transform.SetParent(GameObject.Find("Global/").transform);dicFunc2Object = new Dictionary<CoroutineFunc, GameObject>();}public void Destroy(){UnityEngine.Object.Destroy(root);}public void StartCoroutine(CoroutineFunc func){if (dicFunc2Object.ContainsKey(func)){HotfixMonoCoroutine cor =         dicFunc2Object[func].GetComponent<HotfixMonoCoroutine>();cor.StartCoroutine(func());}else{GameObject obj = new GameObject();                obj.transform.SetParent(GameObject.Find("Global/CoroutineRoot/").transform);HotfixMonoCoroutine cor = obj.AddComponent<HotfixMonoCoroutine>();dicFunc2Object[func] = obj;cor.StartCoroutine(func());}}public void StopCoroutine(CoroutineFunc func){GameObject obj = null;if (dicFunc2Object.TryGetValue(func, out obj)){UnityEngine.Object.Destroy(dicFunc2Object[func]);dicFunc2Object.Remove(func);}}

平台预处理

#if UNITY_EDITOR  platform = "hi,大家好,我是在unity编辑模式下";
#elif UNITY_SERVER
#elif UNITY_IPHONE  platform="hi，大家好,我是IPHONE平台";
#elif UNITY_ANDROID  platform="hi，大家好,我是ANDROID平台";
#elif UNITY_STANDALONE_OSX
#elif UNITY_STANDALONE_WIN  platform="hi，大家好,我是Windows平台";
#endif  Debug.Log("Current Platform:" + platform);

DoFile 读取一个Txt
二进制文件的读写 BinaryWriter和BinaryReader（二进制文件的读写）_起个名字好难啊-CSDN博客

string localConfig = Application.dataPath + "/Config/123.txt";
if (File.Exists(localConfig))
{string[] strs = File.ReadAllLines(localConfig);
}

Editor常用点我

画线画圆画弧
①Debug.DrawLine

    public float radius = 10;public float angle = 360;public int smooth = 20;public Vector3 dir = Vector3.right;public bool drawSide = true;void Update(){Vector3 firstPos;Vector3 lastPos = Vector3.zero;for (int i = 0; i <= smooth; i++){firstPos =  Quaternion.Euler(0, 0, (angle  / smooth) * i) * dir * radius;lastPos = Quaternion.Euler(0, 0, (angle / smooth) * (i + 1)) * dir * radius;Debug.DrawLine(firstPos, lastPos, Color.red);}if (drawSide){Vector3 start = Quaternion.Euler(0, 0, -angle) * dir * radius;Debug.DrawLine(transform.position, transform.position + start, Color.red);Debug.DrawLine(transform.position, lastPos, Color.red);}}

②LineRender

private LineRenderer line;//画线
line = this.gameObject.AddComponent<LineRenderer>();
//只有设置了材质 setColor才有作用
line.material = new Material(Shader.Find("Particles/Additive"));
line.SetVertexCount(2);//设置两点
line.SetColors(Color.yellow, Color.red); //设置直线颜色
line.SetWidth(0.1f, 0.1f);//设置直线宽度//设置指示线的起点和终点
line.SetPosition(0, start.position);
line.SetPosition(1, end.position);public float R;//半径
public int N;//不要超过45line.SetVertexCount(N+1);//这里要加1,达成闭合曲线
for (int i = 0; i < N + 1; i++)
{float x = R * Mathf.Cos((360 / N * i) * Mathf.Deg2Rad) + transform.position.x; //确定x坐标float z = R * Mathf.Sin((360 / N * i) * Mathf.Deg2Rad) + transform.position.z; //确定z坐标line.SetPosition(i, new Vector3(x, transform.position.y, z));
}

更多画线工具插件: Physics Debug Extension

音频
插件:wwise(教程看101课程)

控制全局音量
通过 AudioListener.volume来控制场景场景音量
UGUI
进度条 -- 通过改变UI的FillAmount值 UnityEngine.UI.Image healthBar.fillAmount = 0.0f;

艺术字体 -- 对于Text 使用材质和Outline可以制作但会引起drawcall增加
Mask -- 可以遮挡对于制作一些动画比较好但会引起drawcall增加

自动排列用 Layout Group 如果要适配改变大小都要加Content Size Fitter 要改变的设置为preferred size;
渲染

设置窗口(Window->Lighting->Settings)是主要控制unity全局光照(GlobalIllumination GI)的地方。尽管GI的默认设置已经有了很好的效果，lighting设置面板的一些属性可以调节GI处理的很多方面，从而可以定制场景或者优化场景的质量、速度和存储空间。窗口还包括环境光、光晕、雾效、烘焙的设置。

可使用Class.UnityEngine.RenderSettings代码改变这些
路径
各路径的定义：
Resources路径
Resources文件夹是Unity里自动识别的一种文件夹，可在Unity编辑器的Project窗口里创建，并将资源放置在里面。
Resources文件夹下的资源不管是否有用，全部会打包进.apk或者.ipa，并且打包时会将里面的资源压缩处理。
Application.streamingAssetsPath路径
这个文件夹中的资源在打包时会原封不动的打包进去，不会压缩，一般放置一些资源数据。在PC/MAC中可实现对文件的“增删改查”等操作，但在移动端是一个只读路径。
Application.persistentDataPath路径
这个路径可读、可写，但是只能在程序运行时才能读写操作，不能提前将数据放入这个路径。在IOS上可以被iCloud自动备份；

Editor
Application.dataPath : 项目路径/Assets
Application.streamingAssetsPath: 项目路径/Assets/StreamingAssets
Application.temporaryCachePath: C:/Users\username/AppData/Local/Temp/company name/product name
Application.persistentDataPath: C:/Users\username/AppData/LocalLow/company name/product name

PC
Application.dataPath : exe文件夹/项目名_Data
Application.streamingAssetsPath: 项目路径/项目名_Data/StreamingAssets
Application.temporaryCachePath: C:/Users\username/AppData/Local/Temp/company name/product name
Application.persistentDataPath: C:/Users\username/AppData/LocalLow/company name/product name

安卓
Application.dataPath : /data/app/xxx.xxx.xxx.apk
Application.streamingAssetsPath : jar:file:///data/app/xxx.xxx.xxx.apk/!/assets（只读不可写）
Application.persistentDataPath : /data/data/xxx.xxx.xxx/files（运行可读写）
Application.temporaryCachePath : /data/data/xxx.xxx.xxx/cache

IOS平台
Application.dataPath : Application/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/xxx.app/Data
Application.streamingAssetsPath : Application/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/xxx.app/Data/Raw
Application.persistentDataPath : Application/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Documents
Application.temporaryCachePath : Application/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Library/Caches

Unity特性

1.unity具有特殊意义的文件夹

link

2.Editor的support文件夹

打包支持在Editor/Data/PlaybackEngines

3.unity时间函数执行顺序

数学相关

向量与夹角与三角函数

//U3D  Vector3.forward 实际是(0,0,1) 向前的意思 也就是右上角Z轴方向
//forward是蓝色箭头方向 back是反方向  right是红色箭头方向 left反之 up是绿色箭头方向 down反之Vector3 vector = targetPos - originPos;//任意两点向量 = V3目标位置 - V3起点位置
float angle = Vector3.Angle(from, to); //向量夹角 v3.angle(向量A,向量B)
Vector3.Normalize;//单位向量//Deg2Rad 度转弧度 ; Rad2Deg 弧度转度
//求角度的三角函数值
Mathf.Sin(Mathf.Deg2Rad * angle);
//求变长求角度
Mathf.Atan2(y,x) * Mathf.Rad2Deg;

其他

Windows工具：
svn项目同步
AutoHotKey作为快捷键操作打开
Clover作为打开文件夹的工具
SETUNA作为截图工具
Mac鸡工具
连接:可以使用vnc viewer
项目管理:Cornerstone
调试
调试安卓：直接在调试面板Console/Profiler输入ip链接（unity在2020的新版中甚至支持无需编译改代码）
苹果：链接XCode调试