Unity中关于四元数的API详解
Quaternion类
Quaternion（四元数）用于计算Unity旋转。它们计算紧凑高效，不受万向节锁的困扰，并且可以很方便快速地进行球面插值。 Unity内部使用四元数来表示所有的旋转。
Quaternion是基于复数，并不容易直观地理解。 不过你几乎不需要访问或修改单个四元数参数（x，y，z，w）; 大多数情况下，你只需要获取和使用现有的旋转（例如来自“Transform”），或者用四元数来构造新的旋转（例如，在两次旋转之间平滑插入）。
大部分情况下，你可能会使用到这些函数：
- Quaternion.LookRotation，
- Quaternion.Angle
- Quaternion.Euler
- Quaternion.Slerp
- Quaternion.FromToRotation
- Quaternion.identity。
Quaternion 是一个结构体，本身成员变量相对简单，可以作为函数参数高效传递。
Unity默认方向
在深入了解API之前，我们需要先明确一些基本的概念，就是方向、旋转究竟是如何表示的。
Unity中使用左手坐标系，假如把世界坐标系跟东南西北进行结合起来看，大致如下图所示：
默认的方向对应如下表：
| 坐标轴 | 对应方向 |
|---|---|
| +x | 右(东) |
| -x | 左(西) |
| +y | 上 |
| -y | 下 |
| +Z | 前(北) |
| -Z | 后(南) |
假设以你自己身体为例，你站立在地面上，面朝北方，此时就是默认方向，也就是Unity中的方向就是面向+Z轴方向，那么此时+X轴在东方，+Y轴对应正上方。此时对应的欧拉角是(0,0,0),此时对应的前方矢量是(0,0,1)，上方矢量是(0,1,0)。
这里我区分了左右上下前后的概念，因为这些概念同时也对应了Vector3类、Transform类中的相应的方向函数。
方向的表示法
①欧拉角表示法
假如你使用一组欧拉角表示旋转,XYZ三个参数代表相应轴向按照顺归YZX的旋转，因此(0、90、90)代表先进行+Z轴旋转90度，再沿着+Y轴进行90度旋转，更多详细内容可以参考前述文章《【Unity编程】Unity中的欧拉旋转》。
②前方上方矢量界定法
编程过程中，大部分需要明确指定方位的时候就需要使用这个方法。要确定一个朝向，我们可以使用两个向量来确定：即前方矢量和上方矢量。当一个朝向的前方和上方确定之后，这个朝向也就完全确定了。
举例来说，如果现在只提供一个朝向，就是你现在面朝北方，那么这个方向已经完全确定了吗？显然没有。因为你右侧躺在地上，看向北方，还是在面朝北方，这时候就需要另外一个矢量，也就是上方。当给出上方之后，这个朝向就完全确定了。
上方需要严格给出吗？
在Unity中，我们很多时候，不需要给出严格的上方朝向。比如，仍然是上面那个例子，如果我面朝北方，先给出(0,0,1)代表我的前方矢量。那么，如果我给出的方向不是严格的上方矢量，比如是(0,0.5,0.5)，是否可以？答案也是可以的，因为这两个矢量显然已经确定了一个方向，前方是严格的，而实际的上方可以通过前方朝着你给出的上方矢量旋转90度得出。也就是说，你给(0,1,0)作为上方矢量，和给出在下图中弧度范围内(不包含+Z和-Z)所有方向的矢量都是相同的结果。
③绕轴旋转界定法
第三种定义旋转的方法就是围绕某个指定的轴向旋转一定的角度。这个方法也可以确定一个相对旋转，它以从默认方向(此时前方+Z，上方+Y)出发，沿着指定的轴向进行指定角度的旋转，旋转后的前方和上方是确定的。因此这个方法也可以用来确定朝向。
④A向到B向相对旋转表示法
还有一种方法就是从A向到B向的相对旋转，这种表示了一个旋转的相对变化。比如A为(0,1,0)，B为(0,0,1)，也就是相对旋转量代表原来的上方被旋转到了前方，这样的一个四元数也可以用欧拉角表示成(90,0,0)，也就是沿着+X轴旋转了90度。
注意上面四中表示方法中，有的明确表明了上方矢量，有的好像只明确了前方矢量，要明确的一点就是，它们都是从默认矢量出发的，如果没有明确指定上方朝向，那么就是使用默认的上方，也就是+Y方向。
成员变量
- eulerAngles 欧拉角，返回当前四元数所对应的欧拉角
- this[int] 可以使用类似数组和下标的形式从四元数中获取四个四元数参数
- x、y、z、w 分别代表x、y、z、w 参数，具体代表的内容可以参考前文《【Unity编程】四元数(Quaternion)与欧拉角》，你最好不要通过修改四个参数来改变四元数，除非你真的非常了解它们的含义。
静态成员
- identity 单位四元数，也就是默认的无旋转状态，此时与世界坐标相同，前方指向+Z，上方指向+Y
成员函数
| 函数形式 | 解释 |
|---|---|
| void Set(float new_x, float new_y, float new_z, float new_w) | 设置x、y、z、w 分量，与this[]功能相同 |
| void SetFromToRotation(Vector3 fromDirection, Vector3 toDirection) | 设置成静态函数FromToRotation的结果 |
| void SetLookRotation(Vector3 view, Vector3 up = Vector3.up) | 设置成静态函数LookRotation的结果 |
| void ToAngleAxis(out float angle, out Vector3 axis) | 设置成静态函数AngleAxis的结果 |
说明：成员函数几个set方法多用于将当前四元数设置成目标四元数，目标四元数的构建方法与对应名称的静态函数相同。
静态函数
| 函数形式 | 解释 |
|---|---|
| static float Angle(Quaternion a, Quaternion b) | 计算两个四元数前方矢量之间的夹角度数 |
| static Quaternion AngleAxis(float angle, Vector3 axis) | 构建一个四元数，它表示沿着一个轴旋转固定角度，即上述表示法③ |
| static float Dot(Quaternion a, Quaternion b) | 计算两个四元数之间的点积，返回一个标量，这个函数一般用不到，它的点积不代表什么具体的物理含义，具体定义方法见我的前述文章 |
| static Quaternion Euler(float x, float y, float z) | 构建一个四元数，它用欧拉旋转表示，即上述表示法① |
| static Quaternion FromToRotation(Vector3 fromDirection, Vector3 toDirection) | 构建一个四元数，它表示从指向fromDirection方向到指向toDirection方向的相对旋转量，见上述表示法④ |
| static Quaternion Inverse(Quaternion rotation) | 构建一个四元数，它是指定的四元数的逆，也就是逆向旋转，比如原四元数表示相对+X轴旋转了90度，那么此函数结果就是相对+X轴旋转了-90度 |
| static Quaternion Lerp(Quaternion a, Quaternion b, float t) | 构建一个四元数，表示从四元数a到b的球面插值，所谓的插值也就是中间旋转量，从a作为起点，此时对应t为0，到b为终点，此时对应t为1。当t取0-1之间的小数时，就代表了中间的插值结果。这个方法与Slerp相同，计算速度快，但是精度低，如果相对旋转变化量很小，则效果不理想 |
| static Quaternion LerpUnclamped(Quaternion a, Quaternion b, float t) | 与Lerp相同，区别是，Lerp的t值会被钳制在[0,1]之间，而此方法则不会，t允许超出计算 |
| static Quaternion LookRotation(Vector3 forward, Vector3 upwards = Vector3.up) | 构建一个四元数，使用前方上方矢量确定朝向，也就是上述表示法② |
| static Quaternion RotateTowards(Quaternion from, Quaternion to, float maxDegreesDelta) | 构建一个四元数，表示从一个四元数from(的前方)向着另外一个四元数(的前方)旋转，但不能超出指定的角度，也就是如果两个前方矢量夹角超过指定角度，则旋转到达指定角度时就停止，若是夹角本身不足的话，则结果直接为目标四元数to，与上述表示法④的意思很接近 |
| static Quaternion Slerp(Quaternion a, Quaternion b, float t) | 球面插值，与Lerp功能相同，t值也被钳制，计算精度高，但是速度相对较慢 |
| static Quaternion SlerpUnclamped(Quaternion a, Quaternion b, float t) | 与Slerp功能相同，只是t值不被钳制，允许超出计算 |
| static Quaternion operator * (Quaternion lhs, Quaternion rhs) | 乘法运算符重载，当表示两个连续的旋转时，可以使用lhs * rhs的形式得出连续旋转的结果,lhs为左值，rhs为右值。注意左值是先进行的旋转，叠加右值旋转。用法示例:lhs = lhs * rhs; |
| static Vector3 operator *(Quaternion rotation, Vector3 point) | 乘法运算符重载，表示对一个矢量point施加旋转rotation，得出旋转后的结果矢量。用法示例:Vector3 result=rotation * point |
验证前方上方矢量表示法
为了验证前方上方矢量表示法的实际上方会重新计算，我设计了以下小实验。
在场景中设置三个物体，它们的朝向是打乱的，从左到右分别对应1、2、3。可以使用以下代码将三个物体朝向调整为一致。
//前方上方矢量界定法的实际上方会重新计算m_t1.transform.rotation = Quaternion.LookRotation(Vector3.forward, Vector3.up);m_t2.transform.rotation = Quaternion.LookRotation(Vector3.forward, new Vector3(0,0.5f,-0.5f));m_t3.transform.rotation = Quaternion.LookRotation(Vector3.forward, new Vector3(0,0.5f,0.5f));
在start方法中执行上述代码后，如下：
三个物体朝向是一致的，也就说明了上方矢量确实是进行了重新计算。
总结几种表示方法
下面使用代码总结几种表示法，对应同样的四元数，大致有四种表示方法。
//旋转量的4种表示形式Quaternion q1=Quaternion.Euler(90, 0, 0);Quaternion q2 = Quaternion.LookRotation(Vector3.down ,Vector3.forward);Quaternion q3 = Quaternion.AngleAxis(90,Vector3.right);Quaternion q4 = Quaternion.FromToRotation(Vector3.up, Vector3.forward);showQ("q1",q1);showQ("q2",q2);showQ("q3",q3);showQ("q4",q4);
它们的输出结果是：
也就是说，这几种形式表示的四元数结果完全相同。
将四元数旋转应用于子弹射击示例
当枪管转动起来，子弹仍然沿着正确的朝向发射出去，可以使用很简单的几句话，修改之前的代码后如下：
Bullet_2 bullet = m_compPool.takeUnit<Bullet_2>();//发射时，将子弹的初始位置为枪口的当前位置bullet.m_transform.position = m_transform.position;//将子弹的初始化旋转设置为指向当前枪口前方bullet.m_transform.rotation = Quaternion.LookRotation(m_transform.forward);
本节代码可点此下载。觉得有用你就点个赞。
