AlicizaX/com.alicizax.unity.framework
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

工具类重新整合

Browse Source
This commit is contained in:
陈思海 2026-03-23 19:10:57 +08:00
parent b01ada2f40
commit 1a9a59ab07
54 changed files with 1449 additions and 490 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
Runtime/ABase/Extension/Extension/ArrayExtensions.cs Normal file
View File

@ -0,0 +1,56 @@
using UnityEngine;
[UnityEngine.Scripting.Preserve]
public static class ArrayExtensions
{
/// <summary>
/// 从数组中随机取一个元素。
/// </summary>
public static T Random<T>(this T[] items)
{
System.Random rnd = new System.Random();
if (items.Length > 0)
{
return items[rnd.Next(0, items.Length)];
}
return default;
}
/// <summary>
/// 获取与目标值最接近的元素索引。
/// </summary>
public static int ClosestIndex(this int[] array, int value)
{
int closestIndex = 0;
int minDifference = Mathf.Abs(array[0] - value);
for (int i = 1; i < array.Length; i++)
{
int difference = Mathf.Abs(array[i] - value);
if (difference < minDifference)
{
minDifference = difference;
closestIndex = i;
}
}
return closestIndex;
}
}
namespace AlicizaX
{
[UnityEngine.Scripting.Preserve]
public static class MinMaxExtensions
{
public static float Random(this MinMax minMax)
{
return UnityEngine.Random.Range(minMax.RealMin, minMax.RealMax);
}
public static int Random(this MinMaxInt minMax)
{
return UnityEngine.Random.Range(minMax.RealMin, minMax.RealMax);
}
}
}

5
Runtime/ABase/Helper/RandomHelper.cs.meta → Runtime/ABase/Extension/Extension/ArrayExtensions.cs.meta
View File

@ -1,8 +1,7 @@
fileFormatVersion: 2
guid: c7bd0b921d0715a4caa7a59d261e8803
timeCreated: 1474942922
licenseType: Pro
guid: ae1b3849ddfb58045a96ac9927218a73
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0

2
Runtime/ABase/Extension/Extension/CollectionExtensions.cs
View File

@ -145,4 +145,4 @@ namespace System.Collections.Generic
}
}
}
}
}

22
Runtime/ABase/Helper/DistinctHelper.cs → Runtime/ABase/Extension/Extension/EnumerableExtensions.cs
View File

@ -1,27 +1,19 @@
using System;
using System.Collections.Generic;
using System.Linq;
namespace AlicizaX
{
/// <summary>
/// 去重。帮助类
/// </summary>
[UnityEngine.Scripting.Preserve]
public static class DistinctHelper
public static class EnumerableExtensions
{
/// <summary>
/// 根据条件去重
/// 根据指定键进行去重。
/// </summary>
/// <param name="source"></param>
/// <param name="keySelector"></param>
/// <typeparam name="TSource"></typeparam>
/// <typeparam name="TKey"></typeparam>
/// <returns></returns>
[UnityEngine.Scripting.Preserve]
public static IEnumerable<TSource> DistinctBy<TSource, TKey>(this IEnumerable<TSource> source, Func<TSource, TKey> keySelector)
{
var identifiedKeys = new HashSet<TKey>();
foreach (var item in source)
{
if (identifiedKeys.Add(keySelector(item)))
@ -30,5 +22,13 @@ namespace AlicizaX
}
}
}
/// <summary>
/// 判断集合是否包含另一个集合中的所有元素。
/// </summary>
public static bool ContainsAll<T>(this IEnumerable<T> source, IEnumerable<T> values)
{
return !source.Except(values).Any();
}
}
}

11
Runtime/ABase/Extension/Extension/EnumerableExtensions.cs.meta Normal file
View File

@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: c6d80b4ea1444e5ab93a9ae1dbaa6946
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:

107
Runtime/ABase/Extension/Extension/StringExtensions.cs
View File

@ -198,6 +198,30 @@ public static class StringExtension
return string.Format(text, args);
}
/// <summary>
/// 转换为标题格式。
/// </summary>
public static string ToTitleCase(this string str)
{
return CultureInfo.CurrentCulture.TextInfo.ToTitleCase(str.ToLower());
}
/// <summary>
/// 判断字符串是否为空。
/// </summary>
public static bool IsEmpty(this string str)
{
return string.IsNullOrEmpty(str);
}
/// <summary>
/// 返回当前字符串，若为空则返回备用值。
/// </summary>
public static string Or(this string str, string otherwise)
{
return !string.IsNullOrEmpty(str) ? str : otherwise;
}
/// <summary>
/// 将[\n、\t、\r、空格]替换为空,并返回
/// </summary>
@ -226,6 +250,87 @@ public static class StringExtension
return self;
}
/// <summary>
/// 替换起止字符之间的片段。
/// </summary>
public static string ReplacePart(this string str, char start, char end, string replace)
{
int chStart = str.IndexOf(start);
int chEnd = str.IndexOf(end);
string old = str.Substring(chStart, chEnd - chStart + 1);
return str.Replace(old, replace);
}
/// <summary>
/// 替换指定包裹标记中的内容。
/// </summary>
public static string RegexReplaceTag(this string str, char start, char end, string tag, string replace)
{
Regex regex = new Regex($@"\{start}({tag})\{end}");
if (regex.Match(str).Success)
{
return regex.Replace(str, replace);
}
return str;
}
/// <summary>
/// 读取起止字符之间的内容。
/// </summary>
public static bool RegexGet(this string str, char start, char end, out string result)
{
string escapedStart = Regex.Escape(start.ToString());
string escapedEnd = Regex.Escape(end.ToString());
string pattern = $"{escapedStart}(.*?){escapedEnd}";
Match match = Regex.Match(str, pattern);
if (match.Success)
{
result = match.Groups[1].Value;
return true;
}
result = string.Empty;
return false;
}
/// <summary>
/// 读取所有起止字符之间的内容。
/// </summary>
public static bool RegexGetMany(this string str, char start, char end, out string[] results)
{
string escapedStart = Regex.Escape(start.ToString());
string escapedEnd = Regex.Escape(end.ToString());
string pattern = $"{escapedStart}(.*?){escapedEnd}";
MatchCollection matches = Regex.Matches(str, pattern);
if (matches.Count > 0)
{
var matchList = new List<string>();
foreach (Match match in matches)
{
matchList.Add(match.Groups[1].Value);
}
results = matchList.ToArray();
return true;
}
results = Array.Empty<string>();
return false;
}
/// <summary>
/// 以单词为边界替换内容。
/// </summary>
public static string RegexReplace(this string str, string word, string replace)
{
string escapedWord = Regex.Escape(word);
string pattern = $@"\b{escapedWord}\b";
return Regex.Replace(str, pattern, replace);
}
public static int[] SplitToIntArray(this string str, char sep = '+')
{
if (string.IsNullOrEmpty(str))
@ -328,4 +433,4 @@ public static class StringExtension
return null;
}
}
}

8
Runtime/ABase/Extension/UnityEngine.Common.meta Normal file
View File

@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: a4c9cbd4e6d1ba84fb42b601118e51a1
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:

148
Runtime/ABase/Extension/UnityEngine.Common/UnityEngine.CommonExtensions.cs Normal file
View File

@ -0,0 +1,148 @@
using AlicizaX;
using UnityEngine.UI;
namespace UnityEngine
{
[UnityEngine.Scripting.Preserve]
public static class ColorExtensions
{
public static Color Alpha(this Color color, float alpha)
{
color.a = alpha;
return color;
}
public static Color Lightness(this Color color, float lightness)
{
Color.RGBToHSV(color, out var hue, out var saturation, out var _);
return Color.HSVToRGB(hue, saturation, lightness);
}
}
[UnityEngine.Scripting.Preserve]
public static class ImageExtensions
{
public static void Alpha(this Image image, float alpha)
{
Color color = image.color;
color.a = alpha;
image.color = color;
}
}
[UnityEngine.Scripting.Preserve]
public static class AudioSourceExtensions
{
public static void SetSoundClip(this AudioSource audioSource, SoundClip soundClip, float volumeMul = 1f, bool play = false)
{
if (soundClip == null || soundClip.audioClip == null || audioSource == null)
{
return;
}
if (audioSource.clip != soundClip.audioClip)
{
audioSource.clip = soundClip.audioClip;
}
audioSource.volume = soundClip.volume * volumeMul;
if (play && !audioSource.isPlaying)
{
audioSource.Play();
}
}
public static void PlayOneShotSoundClip(this AudioSource audioSource, SoundClip soundClip, float volumeMul = 1f)
{
if (soundClip == null || soundClip.audioClip == null || audioSource == null)
{
return;
}
audioSource.PlayOneShot(soundClip.audioClip, soundClip.volume * volumeMul);
}
}
[UnityEngine.Scripting.Preserve]
public static class LayerMaskExtensions
{
public static bool CompareLayer(this LayerMask layerMask, int layer)
{
return layerMask == (layerMask | (1 << layer));
}
}
[UnityEngine.Scripting.Preserve]
public static class AnimatorExtensions
{
public static bool IsAnyPlaying(this Animator animator)
{
AnimatorStateInfo stateInfo = animator.GetCurrentAnimatorStateInfo(0);
return (stateInfo.length + 0.1f > stateInfo.normalizedTime || animator.IsInTransition(0)) && !stateInfo.IsName("Default");
}
}
[UnityEngine.Scripting.Preserve]
public static class AngleExtensions
{
public static float FixAngle(this float angle, float min, float max)
{
if (angle < min)
{
angle += 360f;
}
if (angle > max)
{
angle -= 360f;
}
return angle;
}
public static float FixAngle180(this float angle)
{
if (angle < -180f)
{
angle += 360f;
}
if (angle > 180f)
{
angle -= 360f;
}
return angle;
}
public static float FixAngle(this float angle)
{
if (angle < -360f)
{
angle += 360f;
}
if (angle > 360f)
{
angle -= 360f;
}
return angle;
}
public static float FixAngle360(this float angle)
{
if (angle < 0f)
{
angle += 360f;
}
if (angle > 360f)
{
angle -= 360f;
}
return angle;
}
}
}

11
Runtime/ABase/Extension/UnityEngine.Common/UnityEngine.CommonExtensions.cs.meta Normal file
View File

@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: fdcd89fb0474b6949b197c7da1cb81fa
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:

0
Runtime/ABase/Extension/UnityEngage.GameObject.meta → Runtime/ABase/Extension/UnityEngine.GameObject.meta
View File

0
Runtime/ABase/Extension/UnityEngage.GameObject/ComponentExtensions.cs → Runtime/ABase/Extension/UnityEngine.GameObject/ComponentExtensions.cs
View File

0
Runtime/ABase/Extension/UnityEngage.GameObject/ComponentExtensions.cs.meta → Runtime/ABase/Extension/UnityEngine.GameObject/ComponentExtensions.cs.meta
View File

28
Runtime/ABase/Extension/UnityEngage.GameObject/UnityEngage.GameObjectExtension.cs → Runtime/ABase/Extension/UnityEngine.GameObject/GameObjectExtensions.cs
View File

@ -3,7 +3,7 @@ using System.Collections.Generic;
namespace UnityEngine
{
public static class UnityEngageGameObjectExtension
public static class GameObjectExtensions
{
public static void SafeDestroySelf(
this Object obj)
@ -81,5 +81,31 @@ namespace UnityEngine
return gameObject.scene.name != null;
}
/// <summary>
/// 设置对象下所有 MeshRenderer 的 rendering layer。
/// </summary>
public static void SetRenderingLayer(this GameObject gameObject, uint layer, bool set = true)
{
if (layer > 31)
{
Debug.LogError("Invalid layer value. Must be between 0 and 31.");
return;
}
uint layerMask = 1u << (int)layer;
foreach (MeshRenderer renderer in gameObject.GetComponentsInChildren<MeshRenderer>())
{
if (set)
{
renderer.renderingLayerMask |= layerMask;
}
else
{
renderer.renderingLayerMask &= ~layerMask;
}
}
}
}
}

0
Runtime/ABase/Extension/UnityEngage.GameObject/UnityEngage.GameObjectExtension.cs.meta → Runtime/ABase/Extension/UnityEngine.GameObject/GameObjectExtensions.cs.meta
View File

63
Runtime/ABase/Extension/UnityEngine.Transform/RectTransformExtensions.cs Normal file
View File

@ -0,0 +1,63 @@
namespace UnityEngine
{
[UnityEngine.Scripting.Preserve]
public static class RectTransformExtensions
{
//重置为全屏自适应UI
public static void ResetToFullScreen(this RectTransform self)
{
self.anchorMin = Vector2.zero;
self.anchorMax = Vector2.one;
self.anchoredPosition3D = Vector3.zero;
self.pivot = new Vector2(0.5f, 0.5f);
self.offsetMax = Vector2.zero;
self.offsetMin = Vector2.zero;
self.sizeDelta = Vector2.zero;
self.localEulerAngles = Vector3.zero;
self.localScale = Vector3.one;
}
//重置位置与旋转
public static void ResetLocalPosAndRot(this RectTransform self)
{
self.localPosition = Vector3.zero;
self.localRotation = Quaternion.identity;
}
public static void SetWidth(this RectTransform rectTransform, float width)
{
Vector2 size = rectTransform.sizeDelta;
size.x = width;
rectTransform.sizeDelta = size;
}
public static void SetHeight(this RectTransform rectTransform, float height)
{
Vector2 size = rectTransform.sizeDelta;
size.y = height;
rectTransform.sizeDelta = size;
}
public static void SetAnchoredX(this RectTransform rectTransform, float x)
{
Vector2 position = rectTransform.anchoredPosition;
position.x = x;
rectTransform.anchoredPosition = position;
}
public static void SetAnchoredY(this RectTransform rectTransform, float y)
{
Vector2 position = rectTransform.anchoredPosition;
position.y = y;
rectTransform.anchoredPosition = position;
}
public static System.Collections.Generic.IEnumerable<RectTransform> GetChildTransforms(this RectTransform rectTransform)
{
foreach (var item in rectTransform)
{
yield return item as RectTransform;
}
}
}
}

0
Runtime/ABase/Extension/UnityEngine.Transform/UnityEngine.UIExtension.cs.meta → Runtime/ABase/Extension/UnityEngine.Transform/RectTransformExtensions.cs.meta
View File

4
Runtime/ABase/Extension/UnityEngine.Transform/UnityEngine.TransformExtension.cs → Runtime/ABase/Extension/UnityEngine.Transform/TransformExtensions.cs
View File

@ -3,7 +3,7 @@ using UnityEngine;
namespace UnityEngine
{
[UnityEngine.Scripting.Preserve]
public static class UnityEngineTransformExtension
public static class TransformExtensions
{
/// <summary>
/// 查找子节点的名称符合的 <see cref="Transform" />。
@ -271,4 +271,4 @@ namespace UnityEngine
}
}
}
}
}

0
Runtime/ABase/Extension/UnityEngine.Transform/UnityEngine.TransformExtension.cs.meta → Runtime/ABase/Extension/UnityEngine.Transform/TransformExtensions.cs.meta
View File

27
Runtime/ABase/Extension/UnityEngine.Transform/UnityEngine.UIExtension.cs
View File

@ -1,27 +0,0 @@
namespace UnityEngine
{
[UnityEngine.Scripting.Preserve]
public static class UnityEngine_UIExtension
{
//重置为全屏自适应UI
public static void ResetToFullScreen(this RectTransform self)
{
self.anchorMin = Vector2.zero;
self.anchorMax = Vector2.one;
self.anchoredPosition3D = Vector3.zero;
self.pivot = new Vector2(0.5f, 0.5f);
self.offsetMax = Vector2.zero;
self.offsetMin = Vector2.zero;
self.sizeDelta = Vector2.zero;
self.localEulerAngles = Vector3.zero;
self.localScale = Vector3.one;
}
//重置位置与旋转
public static void ResetLocalPosAndRot(this RectTransform self)
{
self.localPosition = Vector3.zero;
self.localRotation = Quaternion.identity;
}
}
}

26
Runtime/ABase/Extension/UnityEngine.Vector2/UnityEngine.Vector2Extension.cs
View File

@ -1,26 +0,0 @@
namespace UnityEngine
{
public static class UnityEngineVector2Extension
{
/// <summary>
/// 取 <see cref="Vector2" /> 的 (x, y) 转换为 <see cref="Vector3" /> 的 (x, 0, y)。
/// </summary>
/// <param name="vector2">要转换的 Vector2。</param>
/// <returns>转换后的 Vector3。</returns>
public static Vector3 ToVector3(this Vector2 vector2)
{
return new Vector3(vector2.x, 0f, vector2.y);
}
/// <summary>
/// 取 <see cref="Vector2" /> 的 (x, y) 和给定参数 y 转换为 <see cref="Vector3" /> 的 (x, 参数 y, y)。
/// </summary>
/// <param name="vector2">要转换的 Vector2。</param>
/// <param name="y">Vector3 的 y 值。</param>
/// <returns>转换后的 Vector3。</returns>
public static Vector3 ToVector3(this Vector2 vector2, float y)
{
return new Vector3(vector2.x, y, vector2.y);
}
}
}

55
Runtime/ABase/Extension/UnityEngine.Vector2/Vector2Extensions.cs Normal file
View File

@ -0,0 +1,55 @@
namespace UnityEngine
{
public static class Vector2Extensions
{
/// <summary>
/// 取 <see cref="Vector2" /> 的 (x, y) 转换为 <see cref="Vector3" /> 的 (x, 0, y)。
/// </summary>
/// <param name="vector2">要转换的 Vector2。</param>
/// <returns>转换后的 Vector3。</returns>
public static Vector3 ToVector3(this Vector2 vector2)
{
return new Vector3(vector2.x, 0f, vector2.y);
}
/// <summary>
/// 取 <see cref="Vector2" /> 的 (x, y) 和给定参数 y 转换为 <see cref="Vector3" /> 的 (x, 参数 y, y)。
/// </summary>
/// <param name="vector2">要转换的 Vector2。</param>
/// <param name="y">Vector3 的 y 值。</param>
/// <returns>转换后的 Vector3。</returns>
public static Vector3 ToVector3(this Vector2 vector2, float y)
{
return new Vector3(vector2.x, y, vector2.y);
}
/// <summary>
/// 判断值是否在向量区间内。
/// </summary>
public static bool InRange(this Vector2 vector, float value, bool equal = false)
{
return equal ? value >= vector.x && value <= vector.y : value > vector.x && value < vector.y;
}
/// <summary>
/// 判断角度是否在向量表示的角度区间内。
/// </summary>
public static bool InDegrees(this Vector2 vector, float value, bool equal = false)
{
if (vector.x > vector.y)
{
return equal ? value >= (vector.x - 360f) && value <= vector.y : value > (vector.x - 360f) && value < vector.y;
}
return equal ? value >= vector.x && value <= vector.y : value > vector.x && value < vector.y;
}
/// <summary>
/// 从区间内取随机值。
/// </summary>
public static float Random(this Vector2 vector)
{
return UnityEngine.Random.Range(vector.x, vector.y);
}
}
}

0
Runtime/ABase/Extension/UnityEngine.Vector2/UnityEngine.Vector2Extension.cs.meta → Runtime/ABase/Extension/UnityEngine.Vector2/Vector2Extensions.cs.meta
View File

86
Runtime/ABase/Extension/UnityEngine.Vector3/AxisExtensions.cs Normal file
View File

@ -0,0 +1,86 @@
using AlicizaX;
namespace UnityEngine
{
[UnityEngine.Scripting.Preserve]
public static class AxisExtensions
{
public static Vector3 Convert(this Axis axis) => axis switch
{
Axis.X => Vector3.right,
Axis.X_Negative => Vector3.left,
Axis.Y => Vector3.up,
Axis.Y_Negative => Vector3.down,
Axis.Z => Vector3.forward,
Axis.Z_Negative => Vector3.back,
_ => Vector3.up,
};
public static Vector3 Direction(this Transform transform, Axis axis)
{
return axis switch
{
Axis.X => transform.right,
Axis.X_Negative => -transform.right,
Axis.Y => transform.up,
Axis.Y_Negative => -transform.up,
Axis.Z => transform.forward,
Axis.Z_Negative => -transform.forward,
_ => transform.up,
};
}
public static float Component(this Vector3 vector, Axis axis)
{
return axis switch
{
Axis.X or Axis.X_Negative => vector.x,
Axis.Y or Axis.Y_Negative => vector.y,
Axis.Z or Axis.Z_Negative => vector.z,
_ => vector.y,
};
}
public static Vector3 SetComponent(this Vector3 vector, Axis axis, float value)
{
switch (axis)
{
case Axis.X:
case Axis.X_Negative:
vector.x = value;
break;
case Axis.Y:
case Axis.Y_Negative:
vector.y = value;
break;
case Axis.Z:
case Axis.Z_Negative:
vector.z = value;
break;
}
return vector;
}
public static Vector3 Clamp(this Vector3 vector, Axis axis, MinMax limits)
{
switch (axis)
{
case Axis.X:
case Axis.X_Negative:
vector.x = Mathf.Clamp(vector.x, limits.RealMin, limits.RealMax);
break;
case Axis.Y:
case Axis.Y_Negative:
vector.y = Mathf.Clamp(vector.y, limits.RealMin, limits.RealMax);
break;
case Axis.Z:
case Axis.Z_Negative:
vector.z = Mathf.Clamp(vector.z, limits.RealMin, limits.RealMax);
break;
}
return vector;
}
}
}

11
Runtime/ABase/Extension/UnityEngine.Vector3/AxisExtensions.cs.meta Normal file
View File

@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: b282fd247f4930142a14784638083a56
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:

13
Runtime/ABase/Extension/UnityEngine.Vector3/UnityEngine.Vector3Extension.cs → Runtime/ABase/Extension/UnityEngine.Vector3/Vector3Extensions.cs
View File

@ -3,7 +3,7 @@
/// <summary>
/// 对 Unity 的扩展方法。
/// </summary>
public static class UnityEngineVector3Extension
public static class Vector3Extensions
{
/// <summary>
/// 取 <see cref="Vector3" /> 的 (x, y, z) 转换为 <see cref="Vector2" /> 的 (x, z)。
@ -25,5 +25,14 @@
{
return new Vector3(vector3.x, vector3.y, vector3.z);
}
/// <summary>
/// 按分量相乘。
/// </summary>
public static Vector3 Multiply(this Vector3 lhs, Vector3 rhs)
{
lhs.Scale(rhs);
return lhs;
}
}
}
}

0
Runtime/ABase/Extension/UnityEngine.Vector3/UnityEngine.Vector3Extension.cs.meta → Runtime/ABase/Extension/UnityEngine.Vector3/Vector3Extensions.cs.meta
View File

128
Runtime/ABase/Helper/ApplicationHelper.cs
View File

@ -1,128 +0,0 @@
using UnityEngine;
namespace AlicizaX
{
/// <summary>
/// 应用帮助类
/// </summary>
[UnityEngine.Scripting.Preserve]
public static class ApplicationHelper
{
/// <summary>
/// 是否是编辑器
/// </summary>
[UnityEngine.Scripting.Preserve]
public static bool IsEditor
{
get
{
#if UNITY_EDITOR
return true;
#else
return false;
#endif
}
}
/// <summary>
/// 是否是安卓
/// </summary>
[UnityEngine.Scripting.Preserve]
public static bool IsAndroid
{
get
{
#if UNITY_ANDROID
return true;
#else
return false;
#endif
}
}
/// <summary>
/// 是否是WebGL平台
/// </summary>
[UnityEngine.Scripting.Preserve]
public static bool IsWebGL
{
get { return Application.platform == RuntimePlatform.WebGLPlayer; }
}
/// <summary>
/// 是否是Windows平台
/// </summary>
[UnityEngine.Scripting.Preserve]
public static bool IsWindows
{
get { return Application.platform == RuntimePlatform.WindowsPlayer; }
}
/// <summary>
/// 是否是Linux平台
/// </summary>
[UnityEngine.Scripting.Preserve]
public static bool IsLinux
{
get { return Application.platform == RuntimePlatform.LinuxPlayer; }
}
/// <summary>
/// 是否是Mac平台
/// </summary>
[UnityEngine.Scripting.Preserve]
public static bool IsMacOsx
{
get { return Application.platform == RuntimePlatform.OSXPlayer; }
}
/// <summary>
/// 是否是iOS 移动平台
/// </summary>
[UnityEngine.Scripting.Preserve]
public static bool IsIOS
{
get
{
#if UNITY_IOS
return true;
#else
return false;
#endif
}
}
/// <summary>
/// 退出
/// </summary>
public static void Quit()
{
#if UNITY_EDITOR
UnityEditor.EditorApplication.isPlaying = false;
return;
#endif
Application.Quit();
}
#if UNITY_IOS
[System.Runtime.InteropServices.DllImport("__Internal")]
private static extern void open_url(string url);
#endif
/// <summary>
/// 打开URL
/// </summary>
/// <param name="url">url地址</param>
public static void OpenURL(string url)
{
#if UNITY_EDITOR
Application.OpenURL(url);
return;
#endif
#if UNITY_IOS
open_url(url);
#else
Application.OpenURL(url);
#endif
}
}
}

3
Runtime/ABase/Helper/ApplicationHelper.cs.meta
View File

@ -1,3 +0,0 @@
fileFormatVersion: 2
guid: 4bb21c08b2dd4b15af73858c5daf4a99
timeCreated: 1676885563

3
Runtime/ABase/Helper/DistinctHelper.cs.meta
View File

@ -1,3 +0,0 @@
fileFormatVersion: 2
guid: 777c1056a4804d90960109d21275c56e
timeCreated: 1670814641

4
Runtime/ABase/Helper/FileHelper.cs
View File

@ -152,9 +152,9 @@ namespace AlicizaX
{
if (Application.platform == RuntimePlatform.Android)
{
if (PathHelper.NormalizePath(path).Contains(PathHelper.AppResPath))
if (Utility.Path.NormalizePath(path).Contains(Utility.Path.AppResPath))
{
readPath = path.Substring(PathHelper.AppResPath.Length);
readPath = path.Substring(Utility.Path.AppResPath.Length);
return true;
}
}

58
Runtime/ABase/Helper/NetworkHelper.cs
View File

@ -1,58 +0,0 @@
using System.Collections.Generic;
using System.Net;
using UnityEngine;
namespace AlicizaX
{
/// <summary>
/// 网络帮助类
/// </summary>
public static class NetworkHelper
{
/// <summary>
/// 获取本地的IP列表
/// </summary>
/// <returns></returns>
public static string[] GetAddressIPs()
{
//获取本地的IP地址
var list = Dns.GetHostEntry(Dns.GetHostName()).AddressList;
string[] addressIPs = new string[list.Length];
for (var index = 0; index < list.Length; index++)
{
IPAddress address = list[index];
addressIPs[index] = address.ToString();
}
return addressIPs;
}
/// <summary>
/// 是否有网络
/// </summary>
/// <returns></returns>
public static bool IsReachable()
{
return Application.internetReachability != NetworkReachability.NotReachable;
}
/// <summary>
/// 是否是WIFI
/// </summary>
/// <returns></returns>
public static bool IsWifi()
{
return Application.internetReachability == NetworkReachability.ReachableViaLocalAreaNetwork;
}
/// <summary>
/// 是否是移动网络
/// </summary>
/// <returns></returns>
public static bool IsViaCarrierData()
{
//当用户使用移动网络时
return Application.internetReachability == NetworkReachability.ReachableViaCarrierDataNetwork;
}
}
}

3
Runtime/ABase/Helper/NetworkHelper.cs.meta
View File

@ -1,3 +0,0 @@
fileFormatVersion: 2
guid: debb4ec407ad464e9aa0cbee452683e1
timeCreated: 1666448562

12
Runtime/ABase/Helper/ObjectHelper.cs
View File

@ -1,12 +0,0 @@
namespace AlicizaX
{
[UnityEngine.Scripting.Preserve]
public static class ObjectHelper
{
[UnityEngine.Scripting.Preserve]
public static void Swap<T>(ref T t1, ref T t2)
{
(t1, t2) = (t2, t1);
}
}
}

3
Runtime/ABase/Helper/ObjectHelper.cs.meta
View File

@ -1,3 +0,0 @@
fileFormatVersion: 2
guid: 41b9276a283a4b6a9afcdde1b884ff70
timeCreated: 1667393013

112
Runtime/ABase/Helper/PathHelper.cs
View File

@ -1,112 +0,0 @@
using System.Text;
using UnityEngine;
namespace AlicizaX
{
public static class PathHelper
{
/// <summary>
///应用程序外部资源路径存放路径(热更新资源路径)
/// </summary>
[UnityEngine.Scripting.Preserve]
public static string AppHotfixResPath
{
get
{
string game = Application.productName;
string path = $"{Application.persistentDataPath}/{game}/";
return path;
}
}
/// <summary>
/// 应用程序内部资源路径存放路径
/// </summary>
public static string AppResPath
{
get { return NormalizePath(Application.streamingAssetsPath); }
}
/// <summary>
/// 应用程序内部资源路径存放路径(www/webrequest专用)
/// </summary>
[UnityEngine.Scripting.Preserve]
public static string AppResPath4Web
{
get
{
#if UNITY_IOS || UNITY_STANDALONE_OSX || UNITY_STANDALONE_WIN || UNITY_EDITOR
return $"file://{Application.streamingAssetsPath}";
#else
return NormalizePath(Application.streamingAssetsPath);
#endif
}
}
/// <summary>
/// 获取平台名称
/// </summary>
public static string GetPlatformName
{
get
{
#if UNITY_ANDROID
return $"Android";
#elif UNITY_STANDALONE_OSX
return $"MacOs";
#elif UNITY_IOS || UNITY_IPHONE
return $"iOS";
#elif UNITY_WEBGL
return $"WebGL";
#elif UNITY_STANDALONE_WIN
return $"Windows";
#else
return string.Empty;
#endif
}
}
/// <summary>
/// 规范化路径
/// </summary>
/// <param name="path"></param>
/// <returns></returns>
public static string NormalizePath(string path)
{
return path.Replace('\\', '/').Replace("\\", "/");
}
static readonly StringBuilder CombineStringBuilder = new StringBuilder();
/// <summary>
/// 拼接路径
/// </summary>
/// <param name="paths"></param>
/// <returns></returns>
public static string Combine(params string[] paths)
{
CombineStringBuilder.Clear();
const string separatorA = "/";
const string separatorB = "\\";
for (var index = 0; index < paths.Length - 1; index++)
{
var path = paths[index];
CombineStringBuilder.Append(path);
if (path.EndsWithFast(separatorA) || path.EndsWithFast(separatorB))
{
continue;
}
if (path.StartsWithFast(separatorA) || path.StartsWithFast(separatorB))
{
continue;
}
CombineStringBuilder.Append(separatorA);
}
CombineStringBuilder.Append(paths[paths.Length - 1]);
return CombineStringBuilder.ToString();
}
}
}

3
Runtime/ABase/Helper/PathHelper.cs.meta
View File

@ -1,3 +0,0 @@
fileFormatVersion: 2
guid: abf5957e17cb46339da8f67cd4074ffd
timeCreated: 1671505311

63
Runtime/ABase/Helper/RandomHelper.cs
View File

@ -1,63 +0,0 @@
using System;
namespace AlicizaX
{
/// <summary>
/// 随机数帮助类
/// </summary>
public static class RandomHelper
{
private static Random _random = new Random((int) DateTime.UtcNow.Ticks);
/// <summary>
/// 设置随机种子
/// </summary>
/// <param name="seed"></param>
public static void SetSeed(int seed)
{
_random = new Random(seed);
}
/// <summary>
/// 获取UInt64范围内的随机数
/// </summary>
/// <returns></returns>
public static ulong NextUInt64()
{
var bytes = new byte[8];
_random.NextBytes(bytes);
return BitConverter.ToUInt64(bytes, 0);
}
/// <summary>
/// 获取Int64范围内的随机数
/// </summary>
/// <returns></returns>
public static long NextInt64()
{
var bytes = new byte[8];
_random.NextBytes(bytes);
return BitConverter.ToInt64(bytes, 0);
}
/// <summary>
/// 获取lower与Upper之间的随机数
/// </summary>
/// <param name="lower"></param>
/// <param name="upper"></param>
/// <returns></returns>
public static int Next(int lower, int upper)
{
return _random.Next(lower, upper);
}
/// <summary>
/// 获取0与1之间的随机数
/// </summary>
/// <returns></returns>
public static float Next()
{
return _random.Next(0, 100_000) / 100_000f;
}
}
}

16
Runtime/ABase/Structs/Pair.cs Normal file
View File

@ -0,0 +1,16 @@
namespace AlicizaX
{
public struct Pair<T1, T2>
{
public T1 Key { get; set; }
public T2 Value { get; set; }
public bool IsAssigned => Key != null && Value != null;
public Pair(T1 key, T2 value)
{
Key = key;
Value = value;
}
}
}

11
Runtime/ABase/Structs/Pair.cs.meta Normal file
View File

@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: b0278c1fdfc27bd4c9419d984d7d0ac1
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:

2
Runtime/ABase/Structs/UniqueID.cs
View File

@ -32,7 +32,7 @@ namespace AlicizaX
/// </summary>
public void Generate()
{
Id = GameHelper.GetGuid();
Id = Utility.IdGenerator.GetGuid();
}
public static implicit operator string(UniqueID uniqueID)

108
Runtime/ABase/Utility/Utility.Gizmo.cs Normal file
View File

@ -0,0 +1,108 @@
using UnityEngine;
#if UNITY_EDITOR
using UnityEditor;
#endif
namespace AlicizaX
{
public static partial class Utility
{
/// <summary>
/// Gizmos 绘制辅助。
/// </summary>
public static class Gizmo
{
public static void DrawArrow(Vector3 position, Vector3 direction, float arrowHeadLength = 0.25f, float arrowHeadAngle = 20f)
{
Gizmos.DrawRay(position, direction);
Vector3 right = Quaternion.LookRotation(direction) * Quaternion.Euler(0, 180 + arrowHeadAngle, 0) * new Vector3(0, 0, 1);
Vector3 left = Quaternion.LookRotation(direction) * Quaternion.Euler(0, 180 - arrowHeadAngle, 0) * new Vector3(0, 0, 1);
Gizmos.DrawRay(position + direction, right * arrowHeadLength);
Gizmos.DrawRay(position + direction, left * arrowHeadLength);
}
public static void DrawWireCapsule(Vector3 p1, Vector3 p2, float radius)
{
#if UNITY_EDITOR
if (p1 == p2)
{
Gizmos.DrawWireSphere(p1, radius);
return;
}
using (new Handles.DrawingScope(Gizmos.color, Gizmos.matrix))
{
Quaternion p1Rotation = Quaternion.LookRotation(p1 - p2);
Quaternion p2Rotation = Quaternion.LookRotation(p2 - p1);
float c = Vector3.Dot((p1 - p2).normalized, Vector3.up);
if (c == 1f || c == -1f)
{
p2Rotation = Quaternion.Euler(p2Rotation.eulerAngles.x, p2Rotation.eulerAngles.y + 180f, p2Rotation.eulerAngles.z);
}
Handles.DrawWireArc(p1, p1Rotation * Vector3.left, p1Rotation * Vector3.down, 180f, radius);
Handles.DrawWireArc(p1, p1Rotation * Vector3.up, p1Rotation * Vector3.left, 180f, radius);
Handles.DrawWireDisc(p1, (p2 - p1).normalized, radius);
Handles.DrawWireArc(p2, p2Rotation * Vector3.left, p2Rotation * Vector3.down, 180f, radius);
Handles.DrawWireArc(p2, p2Rotation * Vector3.up, p2Rotation * Vector3.left, 180f, radius);
Handles.DrawWireDisc(p2, (p1 - p2).normalized, radius);
Handles.DrawLine(p1 + p1Rotation * Vector3.down * radius, p2 + p2Rotation * Vector3.down * radius);
Handles.DrawLine(p1 + p1Rotation * Vector3.left * radius, p2 + p2Rotation * Vector3.right * radius);
Handles.DrawLine(p1 + p1Rotation * Vector3.up * radius, p2 + p2Rotation * Vector3.up * radius);
Handles.DrawLine(p1 + p1Rotation * Vector3.right * radius, p2 + p2Rotation * Vector3.left * radius);
}
#endif
}
public static void DrawWireCapsule(Vector3 position, Quaternion rotation, float radius, float height)
{
#if UNITY_EDITOR
Matrix4x4 angleMatrix = Matrix4x4.TRS(position, rotation, Handles.matrix.lossyScale);
using (new Handles.DrawingScope(angleMatrix))
{
float pointOffset = (height - (radius * 2)) / 2;
Handles.DrawWireArc(Vector3.up * pointOffset, Vector3.left, Vector3.back, -180, radius);
Handles.DrawLine(new Vector3(0, pointOffset, -radius), new Vector3(0, -pointOffset, -radius));
Handles.DrawLine(new Vector3(0, pointOffset, radius), new Vector3(0, -pointOffset, radius));
Handles.DrawWireArc(Vector3.down * pointOffset, Vector3.left, Vector3.back, 180, radius);
Handles.DrawWireArc(Vector3.up * pointOffset, Vector3.back, Vector3.left, 180, radius);
Handles.DrawLine(new Vector3(-radius, pointOffset, 0), new Vector3(-radius, -pointOffset, 0));
Handles.DrawLine(new Vector3(radius, pointOffset, 0), new Vector3(radius, -pointOffset, 0));
Handles.DrawWireArc(Vector3.down * pointOffset, Vector3.back, Vector3.left, -180, radius);
Handles.DrawWireDisc(Vector3.up * pointOffset, Vector3.up, radius);
Handles.DrawWireDisc(Vector3.down * pointOffset, Vector3.up, radius);
}
#endif
}
public static void DrawCenteredLabel(Vector3 position, string labelText, GUIStyle style = null)
{
#if UNITY_EDITOR
if (style == null)
{
style = new GUIStyle(GUI.skin.label);
}
GUIContent content = new GUIContent(labelText);
Vector2 labelSize = style.CalcSize(content);
Vector3 screenPosition = HandleUtility.WorldToGUIPoint(position);
screenPosition.x -= labelSize.x / 2;
screenPosition.y -= labelSize.y / 2;
Vector3 worldPosition = HandleUtility.GUIPointToWorldRay(screenPosition).origin;
Handles.Label(worldPosition, labelText, style);
#endif
}
public static void DrawDisc(Vector3 position, float radius, Color outerColor, Color innerColor)
{
#if UNITY_EDITOR
Handles.color = innerColor;
Handles.DrawSolidDisc(position, Vector3.up, radius);
Handles.color = outerColor;
Handles.DrawWireDisc(position, Vector3.up, radius);
#endif
}
}
}
}

11
Runtime/ABase/Utility/Utility.Gizmo.cs.meta Normal file
View File

@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 1795d7c750b9aaa4abd939fa483d3a66
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:

8
Runtime/ABase/Utility/Utility.IdGenerator.cs
View File

@ -31,6 +31,14 @@ namespace AlicizaX
{
return Interlocked.Increment(ref _intCounter);
}
/// <summary>
/// 生成新的 Guid 字符串。
/// </summary>
public static string GetGuid()
{
return Guid.NewGuid().ToString("N");
}
}
}
}

183
Runtime/ABase/Utility/Utility.Math.cs Normal file
View File

@ -0,0 +1,183 @@
using UnityEngine;
namespace AlicizaX
{
public static partial class Utility
{
/// <summary>
/// 数学和插值相关工具。
/// </summary>
public static class Math
{
public static bool IsApproximate(float valueA, float valueB, float tolerance)
{
return Mathf.Abs(valueA - valueB) < tolerance;
}
public static float PingPong(float min, float max, float speed = 1f)
{
return Mathf.PingPong(Time.time * speed, max - min) + min;
}
public static int Wrap(int value, int min, int max)
{
int newValue = value % max;
if (newValue < min)
{
newValue = max - 1;
}
return newValue;
}
public static float InverseLerp3(float min, float mid, float max, float t)
{
if (t <= min)
{
return 0f;
}
if (t >= max)
{
return 0f;
}
return t <= mid ? Mathf.InverseLerp(min, mid, t) : 1f - Mathf.InverseLerp(mid, max, t);
}
public static float Remap(float minA, float maxA, float minB, float maxB, float t)
{
return minB + (t - minA) * (maxB - minB) / (maxA - minA);
}
public static float EaseOut(float start, float end, float t)
{
t = Mathf.Clamp01(t);
t = Mathf.Sin(t * Mathf.PI * 0.5f);
return Mathf.Lerp(start, end, t);
}
public static float EaseIn(float start, float end, float t)
{
t = Mathf.Clamp01(t);
t = 1f - Mathf.Cos(t * Mathf.PI * 0.5f);
return Mathf.Lerp(start, end, t);
}
public static float SmootherStep(float start, float end, float t)
{
t = Mathf.Clamp01(t);
t = t * t * t * (t * (6f * t - 15f) + 10f);
return Mathf.Lerp(start, end, t);
}
public static float InverseLerp(Vector3 a, Vector3 b, Vector3 value)
{
if (a != b)
{
Vector3 ab = b - a;
Vector3 av = value - a;
float t = Vector3.Dot(av, ab) / Vector3.Dot(ab, ab);
return Mathf.Clamp01(t);
}
return 0f;
}
public static Vector3 QuadraticBezier(Vector3 p1, Vector3 p2, Vector3 cp, float t)
{
t = Mathf.Clamp01(t);
Vector3 m1 = Vector3.LerpUnclamped(p1, cp, t);
Vector3 m2 = Vector3.LerpUnclamped(cp, p2, t);
return Vector3.LerpUnclamped(m1, m2, t);
}
public static Vector3 BezierCurve(float t, params Vector3[] points)
{
if (points.Length < 1)
{
return Vector3.zero;
}
if (points.Length == 1)
{
return points[0];
}
t = Mathf.Clamp01(t);
Vector3[] cp = points;
int n = points.Length - 1;
while (n > 1)
{
Vector3[] rp = new Vector3[n];
for (int i = 0; i < rp.Length; i++)
{
rp[i] = Vector3.LerpUnclamped(cp[i], cp[i + 1], t);
}
cp = rp;
n--;
}
return Vector3.LerpUnclamped(cp[0], cp[1], t);
}
public static Vector3 Lerp3(Vector3 a, Vector3 b, Vector3 c, float t)
{
t = Mathf.Clamp01(t);
if (t <= 0.5f)
{
return Vector3.LerpUnclamped(a, b, t * 2f);
}
return Vector3.LerpUnclamped(b, c, (t * 2f) - 1f);
}
public static Vector3 RangeLerp(float t, params Vector3[] points)
{
if (points.Length < 1)
{
return Vector3.zero;
}
if (points.Length == 1)
{
return points[0];
}
t = Mathf.Clamp01(t);
int pointsCount = points.Length - 1;
float scale = 1f / pointsCount;
float remap = Remap(0f, 1f, 0f, pointsCount, t);
int index = Mathf.Clamp(Mathf.FloorToInt(remap), 0, pointsCount - 1);
float indexT = Mathf.InverseLerp(index * scale, (index + 1) * scale, t);
return Vector3.LerpUnclamped(points[index], points[index + 1], indexT);
}
public static Vector3 Lerp(float t, Vector3[] points)
{
if (points.Length > 3)
{
return RangeLerp(t, points);
}
if (points.Length == 3)
{
return Lerp3(points[0], points[1], points[2], t);
}
if (points.Length == 2)
{
return Vector3.Lerp(points[0], points[1], t);
}
if (points.Length == 1)
{
return points[0];
}
return Vector3.zero;
}
}
}
}

11
Runtime/ABase/Utility/Utility.Math.cs.meta Normal file
View File

@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: eb2b3056e5c86d94697f60d958e1012e
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:

40
Runtime/ABase/Utility/Utility.Net.cs
View File

@ -3,6 +3,7 @@ using System.Collections.Generic;
using System.Net;
using System.Net.NetworkInformation;
using System.Net.Sockets;
using UnityEngine;
namespace AlicizaX
{
@ -13,6 +14,45 @@ namespace AlicizaX
/// </summary>
public static class Net
{
/// <summary>
/// 获取本地 IP 列表。
/// </summary>
public static string[] GetAddressIPs()
{
var list = Dns.GetHostEntry(Dns.GetHostName()).AddressList;
string[] addressIPs = new string[list.Length];
for (int index = 0; index < list.Length; index++)
{
IPAddress address = list[index];
addressIPs[index] = address.ToString();
}
return addressIPs;
}
/// <summary>
/// 是否有网络连接。
/// </summary>
public static bool IsReachable()
{
return Application.internetReachability != NetworkReachability.NotReachable;
}
/// <summary>
/// 是否为局域网或 WiFi 网络。
/// </summary>
public static bool IsWifi()
{
return Application.internetReachability == NetworkReachability.ReachableViaLocalAreaNetwork;
}
/// <summary>
/// 是否为移动网络。
/// </summary>
public static bool IsViaCarrierData()
{
return Application.internetReachability == NetworkReachability.ReachableViaCarrierDataNetwork;
}
/// <summary>
/// 获取第一个可用的端口号
/// </summary>

22
Runtime/ABase/Utility/Utility.Object.cs
View File

@ -1,22 +0,0 @@
namespace AlicizaX
{
public static partial class Utility
{
/// <summary>
/// Object 对象工具类
/// </summary>
public static class Object
{
/// <summary>
/// 交换对象
/// </summary>
/// <param name="t1"></param>
/// <param name="t2"></param>
/// <typeparam name="T"></typeparam>
public static void Swap<T>(ref T t1, ref T t2)
{
(t1, t2) = (t2, t1);
}
}
}
}

3
Runtime/ABase/Utility/Utility.Object.cs.meta
View File

@ -1,3 +0,0 @@
fileFormatVersion: 2
guid: 0264830b4fe54557b5b0f6a6123ffbb1
timeCreated: 1666234520

100
Runtime/ABase/Utility/Utility.Path.cs
View File

@ -1,5 +1,8 @@
using System.IO;
using System.Text;
using UnityEngine;
namespace AlicizaX
{
public static partial class Utility
@ -9,6 +12,62 @@ namespace AlicizaX
/// </summary>
public static class Path
{
private static readonly StringBuilder CombineStringBuilder = new StringBuilder();
/// <summary>
/// 应用程序外部资源路径存放路径(热更新资源路径)。
/// </summary>
public static string AppHotfixResPath
{
get
{
string game = Application.productName;
return $"{Application.persistentDataPath}/{game}/";
}
}
/// <summary>
/// 应用程序内部资源路径存放路径。
/// </summary>
public static string AppResPath => GetRegularPath(Application.streamingAssetsPath);
/// <summary>
/// 应用程序内部资源路径存放路径(www/webrequest专用)。
/// </summary>
public static string AppResPath4Web
{
get
{
#if UNITY_IOS || UNITY_STANDALONE_OSX || UNITY_STANDALONE_WIN || UNITY_EDITOR
return $"file://{Application.streamingAssetsPath}";
#else
return GetRegularPath(Application.streamingAssetsPath);
#endif
}
}
/// <summary>
/// 获取平台名称。
/// </summary>
public static string PlatformName
{
get
{
#if UNITY_ANDROID
return "Android";
#elif UNITY_STANDALONE_OSX
return "MacOs";
#elif UNITY_IOS || UNITY_IPHONE
return "iOS";
#elif UNITY_WEBGL
return "WebGL";
#elif UNITY_STANDALONE_WIN
return "Windows";
#else
return string.Empty;
#endif
}
}
/// <summary>
/// 获取规范的路径。
/// </summary>
@ -24,6 +83,16 @@ namespace AlicizaX
return path.Replace('\\', '/');
}
/// <summary>
/// 获取规范的路径。
/// </summary>
/// <param name="path">要规范的路径。</param>
/// <returns>规范的路径。</returns>
public static string NormalizePath(string path)
{
return GetRegularPath(path);
}
/// <summary>
/// 获取远程格式的路径（带有file:// 或 http:// 前缀）。
/// </summary>
@ -40,6 +109,37 @@ namespace AlicizaX
return regularPath.Contains("://") ? regularPath : ("file:///" + regularPath).Replace("file:////", "file:///");
}
/// <summary>
/// 拼接路径。
/// </summary>
public static string Combine(params string[] paths)
{
if (paths == null || paths.Length == 0)
{
return string.Empty;
}
CombineStringBuilder.Clear();
for (int index = 0; index < paths.Length - 1; index++)
{
string path = paths[index];
if (string.IsNullOrEmpty(path))
{
continue;
}
CombineStringBuilder.Append(path);
char lastChar = path[path.Length - 1];
if (lastChar != '/' && lastChar != '\\')
{
CombineStringBuilder.Append('/');
}
}
CombineStringBuilder.Append(paths[paths.Length - 1]);
return CombineStringBuilder.ToString();
}
/// <summary>
/// 移除空文件夹。
/// </summary>

111
Runtime/ABase/Utility/Utility.Platform.cs Normal file
View File

@ -0,0 +1,111 @@
using UnityEngine;
namespace AlicizaX
{
public static partial class Utility
{
/// <summary>
/// 应用和平台相关的实用函数。
/// </summary>
public static class Platform
{
/// <summary>
/// 是否是编辑器。
/// </summary>
public static bool IsEditor
{
get
{
#if UNITY_EDITOR
return true;
#else
return false;
#endif
}
}
/// <summary>
/// 是否是安卓。
/// </summary>
public static bool IsAndroid
{
get
{
#if UNITY_ANDROID
return true;
#else
return false;
#endif
}
}
/// <summary>
/// 是否是 WebGL 平台。
/// </summary>
public static bool IsWebGL => Application.platform == RuntimePlatform.WebGLPlayer;
/// <summary>
/// 是否是 Windows 平台。
/// </summary>
public static bool IsWindows => Application.platform == RuntimePlatform.WindowsPlayer;
/// <summary>
/// 是否是 Linux 平台。
/// </summary>
public static bool IsLinux => Application.platform == RuntimePlatform.LinuxPlayer;
/// <summary>
/// 是否是 Mac 平台。
/// </summary>
public static bool IsMacOsx => Application.platform == RuntimePlatform.OSXPlayer;
/// <summary>
/// 是否是 iOS 平台。
/// </summary>
public static bool IsIOS
{
get
{
#if UNITY_IOS
return true;
#else
return false;
#endif
}
}
/// <summary>
/// 退出应用。
/// </summary>
public static void Quit()
{
#if UNITY_EDITOR
UnityEditor.EditorApplication.isPlaying = false;
return;
#endif
Application.Quit();
}
#if UNITY_IOS
[System.Runtime.InteropServices.DllImport("__Internal")]
private static extern void open_url(string url);
#endif
/// <summary>
/// 打开 URL。
/// </summary>
public static void OpenURL(string url)
{
#if UNITY_EDITOR
Application.OpenURL(url);
return;
#endif
#if UNITY_IOS
open_url(url);
#else
Application.OpenURL(url);
#endif
}
}
}
}

11
Runtime/ABase/Utility/Utility.Platform.cs.meta Normal file
View File

@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 3b2027d750c54878b78b6e304ed4ad7d
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:

110
Runtime/ABase/Utility/Utility.Random.cs
View File

@ -59,6 +59,35 @@ namespace AlicizaX
return s_Random.NextDouble();
}
/// <summary>
/// 返回一个介于 0.0 和 1.0 之间的随机数。
/// </summary>
/// <returns>大于等于 0.0 并且小于 1.0 的单精度浮点数。</returns>
public static float GetRandomSingle()
{
return (float)s_Random.NextDouble();
}
/// <summary>
/// 返回一个随机的 Int64。
/// </summary>
public static long GetRandomInt64()
{
byte[] bytes = new byte[8];
s_Random.NextBytes(bytes);
return BitConverter.ToInt64(bytes, 0);
}
/// <summary>
/// 返回一个随机的 UInt64。
/// </summary>
public static ulong GetRandomUInt64()
{
byte[] bytes = new byte[8];
s_Random.NextBytes(bytes);
return BitConverter.ToUInt64(bytes, 0);
}
/// <summary>
/// 用随机数填充指定字节数组的元素。
/// </summary>
@ -67,6 +96,87 @@ namespace AlicizaX
{
s_Random.NextBytes(buffer);
}
/// <summary>
/// 获取一个与上次值不同的随机数。
/// </summary>
public static int RandomUnique(int min, int max, int last)
{
if (min + 1 >= max)
{
return min;
}
int result = last;
while (result == last)
{
result = UnityEngine.Random.Range(min, max);
}
return result;
}
/// <summary>
/// 获取一个排除指定值集合的随机数。
/// </summary>
public static int RandomExclude(int min, int max, int[] excludedValues, int maxIterations = 1000)
{
int result;
int iterations = 0;
do
{
if (iterations > maxIterations)
{
return -1;
}
result = UnityEngine.Random.Range(min, max);
iterations++;
}
while (Contains(excludedValues, result));
return result;
}
/// <summary>
/// 获取一个排除现有集合和已选集合的随机数。
/// </summary>
public static int RandomExcludeUnique(int min, int max, int[] excludedValues, int[] currentValues, int maxIterations = 1000)
{
int result;
int iterations = 0;
do
{
if (iterations > maxIterations)
{
return -1;
}
result = UnityEngine.Random.Range(min, max);
iterations++;
}
while (Contains(excludedValues, result) || Contains(currentValues, result));
return result;
}
private static bool Contains(int[] values, int target)
{
if (values == null)
{
return false;
}
for (int i = 0; i < values.Length; i++)
{
if (values[i] == target)
{
return true;
}
}
return false;
}
}
}
}

106
Runtime/ABase/Utility/Utility.Unity.Gameplay.cs Normal file
View File

@ -0,0 +1,106 @@
using UnityEngine;
namespace AlicizaX
{
public static partial class Utility
{
public static partial class Unity
{
public static void ShowCursor(bool locked, bool visible)
{
Cursor.lockState = locked ? CursorLockMode.Locked : CursorLockMode.None;
Cursor.visible = visible;
}
public static bool Raycast(Ray ray, out RaycastHit hitInfo, float maxDistance, int cullLayers, Layer interactLayer)
{
if (Physics.Raycast(ray, out RaycastHit hit, maxDistance, cullLayers))
{
if (interactLayer.CompareLayer(hit.collider.gameObject))
{
hitInfo = hit;
return true;
}
}
hitInfo = default;
return false;
}
public static AudioSource PlayOneShot2D(Vector3 position, AudioClip clip, float volume = 1f, string name = "OneShotAudio")
{
if (clip == null)
{
return null;
}
GameObject gameObject = new GameObject(name);
gameObject.transform.position = position;
AudioSource source = gameObject.AddComponent<AudioSource>();
source.spatialBlend = 0f;
source.clip = clip;
source.volume = volume;
source.Play();
Object.Destroy(gameObject, clip.length * ((Time.timeScale < 0.01f) ? 0.01f : Time.timeScale));
return source;
}
public static AudioSource PlayOneShot2D(Vector3 position, SoundClip clip, string name = "OneShotAudio")
{
if (clip == null || clip.audioClip == null)
{
return null;
}
return PlayOneShot2D(position, clip.audioClip, clip.volume, name);
}
public static AudioSource PlayOneShot3D(Vector3 position, AudioClip clip, float volume = 1f, string name = "OneShotAudio")
{
if (clip == null)
{
return null;
}
GameObject gameObject = new GameObject(name);
gameObject.transform.position = position;
AudioSource source = gameObject.AddComponent<AudioSource>();
source.spatialBlend = 1f;
source.clip = clip;
source.volume = volume;
source.Play();
Object.Destroy(gameObject, clip.length * ((Time.timeScale < 0.01f) ? 0.01f : Time.timeScale));
return source;
}
public static AudioSource PlayOneShot3D(Vector3 position, AudioClip clip, float maxDistance, float volume = 1f, string name = "OneShotAudio")
{
if (clip == null)
{
return null;
}
GameObject gameObject = new GameObject(name);
gameObject.transform.position = position;
AudioSource source = gameObject.AddComponent<AudioSource>();
source.spatialBlend = 1f;
source.clip = clip;
source.volume = volume;
source.maxDistance = maxDistance;
source.Play();
Object.Destroy(gameObject, clip.length * ((Time.timeScale < 0.01f) ? 0.01f : Time.timeScale));
return source;
}
public static AudioSource PlayOneShot3D(Vector3 position, SoundClip clip, string name = "OneShotAudio")
{
if (clip == null || clip.audioClip == null)
{
return null;
}
return PlayOneShot3D(position, clip.audioClip, clip.volume, name);
}
}
}
}

11
Runtime/ABase/Utility/Utility.Unity.Gameplay.cs.meta Normal file
View File

@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: b214adecc8c0fab41b3fcd306d4ebb10
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant: