C# on 无铃怎么系铃

UnityWebRequest

Sat, 15 Nov 2025 16:49:10 +0800

引入

简介

UnityWebRequest 对象用于与 Web 服务器进行通信。 UnityWebRequest 处理 HTTP 与 Web 服务器进行通信的流程。其他对象 - 特别是 DownloadHandler 和 UploadHandler - 分别管理数据的下和上传。

–来自unity文档

基本用法示例

using system.Collections;
using UnityEngine;
using UnityEngine.Networking;

// 下载文本数据
//using 语法是为了确保这些对象在不再需要时能够及时释放资源。
Ienumertor DownloadText(string url)
{
    using(UnityWebRequest request = UnityWebRequest.Get(url))
    {
        yield return request.SendWebRequest();

        if(request.result == UnityWebRequest.Result.Success)
        {
            string text = request.downloadHandler.text;
            Debug.log("Download success: " + text);
        }
    }
}

// 下载文件并保存
IEnumerator DownloadFile(string url, string savePath)
{
    using(UnityWebRequest request = UnityWebRequest.Get(url))
    {
        request.downloadHandler = new DownloadHandlerFile(savePath);
        yield return request.SendWebRequest();
    }
}

// 上传表单数据
IEnumerator UploadData(string url, string data) 
{
    using(UnityWebRequest request = UnityWebRequest.Post(url, data)) 
    {
        byte[] jsonToSend = Encoding.UTF8.GetBytes(data);
        request.uploadHandler = new UploadHandlerRaw(jsonToSend);
        request.downloadHandler = new DownloadHandlerBuffer();
        request.SetRequestHeader("Content-Type", "application/json");
        
        yield return request.SendWebRequest();
    }
}

常通过以下途径创建UnityWebRequest对象

//构造函数，method表示HTTP协议的GET, Post, PUT,不附加method和handler默认为GET method
public UnityWebRequest ();
public UnityWebRequest (string url);
public UnityWebRequest (string url, string method);
public UnityWebRequest (string url, string method, Networking.DownloadHandler downloadHandler, Networking.UploadHandler uploadHandler);

//通过静态函数返回
//这些函数可返回针对许多常见用例相应配置的 UnityWebRequest 对象。请参阅：Get、Post、Put、GetTexture。

public static Networking.UnityWebRequest Get (string uri);
//发送 HTTP HEAD 请求的 UnityWebRequest
public static Networking.UnityWebRequest Head (string uri);
//将原始数据上传到远程服务器的 UnityWebRequest
public static Networking.UnityWebRequest Post (string uri, string postData);
//向 uri 传输 bodyData的 UnityWebRequest
public static Networking.UnityWebRequest Put (string uri, byte[] bodyData);
public static Networking.UnityWebRequest Put (string uri, string bodyData);

可以发现UnityWebRequest包含一些重要变量，常用的是downloadHandler和uploadHandler类的引用,定义如何处理从远程服务器接收的 HTTP 响应体数据。
还有之后的request.SendWebRequest()向url发送请求的方法。这里一般用yield return等待请求完成，防止阻塞主线程。

AsyncProgrammingInUnity

Fri, 05 Sep 2025 23:04:59 +0800

引入

在编写如延时操作，UI和其他动画控制，加载资源（场景，模型和贴图等），等待网络请求等操作时，需要将处理操作分布多帧中或者为了不阻塞主线程需要异步编程。考虑现在可能只需要简单延时操作，UI动画控制，加载等操作，先从unity的协程coroutine和C#的Task类考虑。

unity协程

首先需要知道unity的大部分游戏逻辑，输入处理和渲染都是在主线程处理处理，是单线程的。大部分API只能在主线程调用，子线程尝试调用可能有异常和未定义错误。而unity协程本质上也是在主线程上运行的，协程函数任务被分配到不同帧中处理。

语法

协程方法通过C#的迭代器关键字IEnumerator，定义一个返回迭代器的函数实现；并在函数体通过yiled return YieldInstruction(waitForSeconds,waitForFixedUpdate等的基类)暂停协程函数和决定什么时候恢复执行；最后通过StartCoroutine(IEnumerator routine)开始协程函数。
示例代码如下：

using UnityEngine;

//协程是在MonoBehavour实现，只能在MonoBegaviour脚本中使用
public class TestExample : MonoBehaviour
{
    private IEnumerator Test()
    {
        for(int i = 0; i < 10; i++)
        {
            Debug.Log(i + " loop, in " + Time.frameCount + " frame.");
            yield return null;
        }
    }

    void Start()
    {
        StartCoroutine(Test());
    }
}

//最终输出：
//0 loop, in 1 frame
//1 loop, in 2 frame
//2 loop, in 3 frame
//...
//3 loop, in 10 frame

yield return null即暂停后在下一帧执行。还可以使用：

yield return new WaitForSeconds(1);//等待1秒，受到TimeScale影响。
yield return new WaitForSecondsRealTime(1);//等待1秒，不受到TimeScale影响。
yield return new WaitForFixedUpdate();//等待到下一次fixedUpdate执行。
yield return StartCoroutine(anoTher Coroutine);//等待另一个协程执行完成后。

局限

使用范围

协程只能在继承了MonoBehaviour的类在启动，依赖于组件类型脚本和场景中物体或者空物体。

生命周期问题

协程和挂载脚本的GamwObject绑定，对象销毁，协程停止而不会销毁。可能引发内存泄漏，空引用或者未知错误。

性能问题

yield return 时候频繁创建返回对象造成GC。
由于实际是在主线程上，过多协程还是会造成阻塞。
如果涉及到数据读取，yield return null不好把握一帧读取多少。因为单线程，一帧读取多会阻塞，少了浪费时间。

功能实现局限

协程函数无法返回值
协程函数不能使用try，catch进行错误捕获。

c# Task类

c# Task类是.Net框架下提供异步操作的核心类，基于Thread，ThreadPool的高度抽象。能够以直观，高效的方式编写异步，多线程代码，而不需要关心线程的生命周期，如创建，启动，暂停和恢复等。

基本用法

using System.Threading.Tasks;
private async Task<string> TestAsync()
{
    Debug.Log("async Task start!");
    await Task.Delay(3000);
    return "Task completed! return result";
}

private async void Start()
{
    string res = await TestAsync();
    Debug.log("res");
}

private void Update()
{
    Debug.log("Update!");
}


//预期输出：
//async Task start
//Update!
//Update:
//.....
//after 3s
//Task completed! return result

async关键字允许函数进行异步操作，即可以在函数中使用await关键字。当遇到需要等待另一个任务完成，使用await关键字会暂停函数将控制权返回到调用方，等待任务完成后再回到该异步函数。

Task常用函数

using System.Thread.Tasks;

Task.Run(Action action);//委托或者lambda函数表达式。
Task.Delay(Int time);//创建在time秒后结束的任务。
Task.WhenAll(Task[] tasks)//等待数组中所有任务完成。
Task.WhenAny(Task[] tasks)//等待数组中任一任务完成。

除此以外还有其他高级用法，现阶段可能还用不上，等有更高级的需求在补充。

Csharp中的委托，事件和Unity中的特殊事件类型

Sun, 17 Aug 2025 22:28:25 +0800

C#委托

介绍

在C#里委托是一种类型安全的函数指针，类似于C/C++中的函数指针，相当于C#的引用之于C/C++的指针一样，提供类似指针的操作，但是更加安全。
且委托允许指向多个函数，即多播。

语法

委托的声明。

//委托声明
public delegate 返回类型 委托名(参数列表);
//如下
public delegate int MathOperation(int x, int y);

在声明委托之后，通过new来实例化一个委托。之后就可以通过委托来调用其引用的函数。

//委托声明
public delegate int MathOperation(int x, int y);
public int add(int x, int y)
{
    return x + y;
}
//实例化时，构造参数不能为空。
MathOperation mo = new MathOperation(add);
int res = mo(3, 5);
//res = 8

相同类型的委托可以进行合并。让所有委托时调用多个函数。

//续之前代码
int a = 1;
public delegate void ChangeA(int b);
public void add(int b)
{
    a += b;
} 
public void multi(int b)
{
    a *= b
}
ChangeA ca;
ChangeA ca1 = new ChangeA(add);
ChangeA ca2 = new ChangeA(multi);
ca = ca1;
ca += ca2;
ca(5);
//a = 30;

委托还可以通过-=来移除引用的函数。

`1`	`ca -= multi;`

委托可以作为函数参数。

//如
public int testFunc(int a, MathOperation mo)
{
    return mo(a, a);
}

其他

C#提供了几种常见的泛型委托类型，可以使用这些直接实例化常见的委托。

//Action表示不返回值的函数，最多接收16个参数。
public Action<string, int> action = func;
//Action表示有返回值的函数，最多接收16个参数。
//只有一个泛型参数时，代表返回值类型。
//多个时最后一个为返回类型，其他为输入类型。
public Func<int, int, int> addFunc = func;
//Predicate表示返回bool值的函数，泛型参数为输入类型。
public Predicate<int, int> isTrue = func;

另外C#匿名函数的使用也会使用delegate关键字。或者类似C++11Lambda表达式那样更简洁的写法。

//在需要函数(即委托)作为参数时，可以直接使用匿名函数。
public void test(Func<int, int> func)
{
    console.writeLine(func(2));
}
//delegate关键字创建匿名函数。
test(delegate(int a){return a * a;});
test(delegate(int a){return a + 5;});
//lambda表达式创建匿名函数
test((int a) => {return a * a;});
test((int a) => a * a);
//输出:
//4
//7

但是因为匿名函数是没有名字的函数，所以如果在委托中添加一个匿名函数，是没办法减掉这个匿名函数的。
如果匿名函数中使用了外部函数的变量，可能导致该变量的生命周期延长，产生异常结果。可以使用static声明不捕获外部变量的匿名函数。

C#事件

介绍

知道了委托的用处，第一反应就是可以用于游戏中的事件处理。
但是同时会发现使用委托实现观察者模式(又名发布-订阅模式，我个人更喜欢这个名字)，特别是一个发布，多个订阅时，会发现委托不能直接添加函数，添加订阅时需要创建多个委托后进行合并，比较麻烦。其实C#已经提供了实现发布-订阅模式，且使用方便的事件类型。
C#事件就是对委托进行了封装，来实现发布-订阅模式的一个类型。

语法

//声明事件之前，需要声明该事件的委托类型(即该事件发生时调用什么样的函数)。
public delegate void testHandler(string args);
//再基于声明的委托定义事件。
public event testHandler Ontest;
//事件的触发,事件只能在定义事件类里面触发即事件由发布者发布。
//？用于检查事件中委托引用的函数是否为空，保证只要有订阅者才触发。
Ontest?.Invoke(s);
//事件的订阅和取消订阅。提供-=，+=
Ontest += funcName;
Ontest -= funcName;

完整的发布-订阅模式实现

//事件的委托类型经常命名为XXHandler
public delegate void testHandler(string args);
//发布者
public class Pulisher
{
    public event testHandler Ontest;
    public void OntestInvoke(string a)
    {
        Ontest?.Invoke(s);
    }

    //模拟事件的触发
    public void StartTest()
    {
        OntestInvoke("sss");
    }
}
//订阅者
public class subscriber
{
    public void subscribe(Pulisher pulisher)
    {
        pulisher.Ontest += react;
    }

    //订阅者对事件发生做出反应
    private void react(string s)
    {
        Console.WriteLine(s);
    }
}

static void main(sting[] args)
{
    Pulisher p = new Pulisher();
    subscriber s = new subscriber();
    s.subscribe(p);

    subscriber s1 = new subscriber();
    s1.subscribe(p);
    //多个订阅者

    //事件触发
    p.StartTest();
    //输出：
    //sss
    //sss
    //做出了反应。
}

unityEvent

发布-订阅模式是游戏中常用的设计模式，robloxstudio和godot都提供了在编辑器配置事件的方法，unity也有相关功能。
unityEvent是unity提供的对事件操作的api，unityevent允许在inspector直接添加或者删除订阅者函数，简化了代码的书写。

using UnityEngine.Events;
public class tester : MonoBehavior
{
    public UnityEvent unityEvent;

    //模拟事件触发
    public void Invoke()
    {
        unityEvent?.Invoke();
    }
}

这样就可以在inspector看见类似button的onclick的事件ui。

想要带有参数需要重载unityEvent<T0>,unityEvent<T0, T1> 抽象类。

using UnityEngine.Events;
[Serializable]
public class FloatEvent : UnityEvent<float>{};
public class tester : MonoBehavior
{
    public UnityEvent unityEvent;
    public FloatEvent floatEvent;

    //模拟事件触发
    public void Invoke()
    {
        unityEvent?.Invoke();
    }

    public void FloatInvoke()
    {
        FloatEvent?.Invoke(0.5f);
    }
}

也可以在代码中添加和删除监听

1
2

unityEvent.AddListener(funcName);
unityEvent.RemoveListener(funcName);

相关链接:
委托的菜鸟教程相关页面。
事件的菜鸟教程相关页面。
匿名函数和lambda菜鸟教程相关页面。
CSDN,匿名函数和lambda。
CSDNunity事件。
Unity官方，UnityEvent相关文档手册部分和脚本API部分。