求助：如何在Unity中基于Agora搭建基础直播视频流？

Hey there! I totally get how frustrating vague official docs can be when you're just dipping your toes into Agora live streaming in Unity. Let's cut through the confusion and break down exactly what code goes where, and why.

🔧 代码应该放在Start()里（一次性初始化） #

几乎所有Agora的核心初始化和配置操作都应该放在这里——这些操作只需要在场景加载时执行一次，不需要每帧重复运行：

• Agora引擎初始化：用IRtcEngine.GetEngine(appId)获取引擎实例是一劳永逸的操作。如果放在Update()里会创建重复的引擎实例，引发各种奇怪的bug。
• 启用核心模块：mRtcEngine.EnableVideo()或mRtcEngine.EnableAudio()这类调用只需要触发一次，就能开启对应的音视频模块。
• 加入频道：mRtcEngine.JoinChannel(null, channelName, "", 0)是单次操作——如果放在Update()里会重复加入频道，导致连接错误和不可预料的频道行为。
• 视频渲染设置：绑定本地VideoSurface组件（比如mRtcEngine.SetLocalVideoSurface(localVideoSurface)）或者配置远程视频预设，都应该在初始化阶段完成一次。
• 注册回调事件：订阅Agora的事件系统（比如mRtcEngine.OnUserJoined += OnUserJoined）只需要执行一次。如果在Update()里重复注册，会导致事件被多次触发。

⚠️ 极少需要放在Update()里的代码（尽量避免） #

Agora是基于事件驱动回调设计的，而非逐帧轮询。不过有极少数动态的、用户可控的操作可能适合放在这里：

• 实时音量调节：如果你有UI滑块让用户实时调整麦克风/扬声器音量，可以在Update()里更新mRtcEngine.AdjustRecordingVolume()或mRtcEngine.AdjustPlaybackVolume()。但其实更优的方式是用滑块的数值变更事件，而非逐帧轮询。
• 动态网络状态检查：不推荐这么做——Agora提供了OnNetworkQuality回调来通知你网络状态变化，所以优先用回调而非在Update()里手动检查。

经验法则：如果你想把Agora代码放在Update()里，先问自己："这个操作能不能用Agora的回调或者UI事件来处理？" 十有八九答案是肯定的。

🧹 在OnDestroy()里的关键清理 #

别漏掉这一步！当脚本被销毁时，一定要清理Agora资源，避免内存泄漏：

void OnDestroy()
{
    if (mRtcEngine != null)
    {
        mRtcEngine.LeaveChannel();
        IRtcEngine.Destroy();
        mRtcEngine = null;
    }
}

📝 完整极简示例 #

下面是一个精简的可运行脚本，把所有内容整合在一起：

using UnityEngine;
using agora_gaming_rtc;

public class AgoraBasicLive : MonoBehaviour
{
    [SerializeField] private string yourAgoraAppId = "你的Agora AppID";
    [SerializeField] private string channelName = "MyFirstLiveChannel";
    [SerializeField] private VideoSurface localVideoFeed;

    private IRtcEngine _agoraEngine;

    void Start()
    {
        // 初始化引擎
        _agoraEngine = IRtcEngine.GetEngine(yourAgoraAppId);
        
        // 启用视频并设置本地画面
        _agoraEngine.EnableVideo();
        if (localVideoFeed != null)
        {
            localVideoFeed.SetForUser(0);
            localVideoFeed.SetEnable(true);
        }

        // 注册关键回调
        _agoraEngine.OnUserJoined += HandleRemoteUserJoined;
        _agoraEngine.OnUserOffline += HandleRemoteUserLeft;

        // 加入直播频道
        _agoraEngine.JoinChannel(null, channelName, "", 0);
    }

    private void HandleRemoteUserJoined(uint userId, int elapsed)
    {
        Debug.Log($"远程用户 {userId} 加入了频道！");
        // 在这里实例化远程VideoSurface并关联用户ID
        // 示例：
        // GameObject remoteVideo = Instantiate(remoteVideoPrefab, transform);
        // VideoSurface remoteSurface = remoteVideo.GetComponent<VideoSurface>();
        // remoteSurface.SetForUser(userId);
        // remoteSurface.SetEnable(true);
    }

    private void HandleRemoteUserLeft(uint userId, USER_OFFLINE_REASON reason)
    {
        Debug.Log($"远程用户 {userId} 离开了频道。");
        // 在这里清理远程VideoSurface对象
    }

    void OnDestroy()
    {
        // 资源清理
        if (_agoraEngine != null)
        {
            _agoraEngine.LeaveChannel();
            IRtcEngine.Destroy();
            _agoraEngine = null;
        }
    }

    // 一个极少出现在Update()里的合理示例（音量控制）
    // [SerializeField] private Slider micVolumeSlider;
    // void Update()
    // {
    //     if (micVolumeSlider != null && _agoraEngine != null)
    //     {
    //         _agoraEngine.AdjustRecordingVolume((int)(micVolumeSlider.value * 100));
    //     }
    // }
}

内容的提问来源于stack exchange，提问作者Gerome Pojas