# 迁移指南 (/zh-CN/realtime-media/rtc/reference/migration-guide/web) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). Web SDK 4.x 是基于 Web SDK 3.x 开发的全量重构版本,在继承了 Web SDK 3.x 功能的基础上,优化了 SDK 的内部架构,提高了 API 的易用性,具体包括以下优势: - 使用基于 Promise-based 的 API 来实现异步操作,提升集成代码健壮性和可读性。 - 支持 TypeScript。 - 以 Track 对象取代 Stream 对象来控制音视频,音视频逻辑互不干扰、各自独立,更为灵活。 - 优化了频道事件通知机制,统一了频道内事件的命名和回调参数的格式,降低断线重连的处理难度。 - 提供清晰和完善的错误码,方便错误排查。 本文介绍如何从 Web SDK 3.x 及以下版本升级至 Web SDK 4.x 版本。 :::warning[注意] - 声网已经停止维护 Web SDK 3.x 版本。建议你选择合适的时机,参考本文从 3.x 及以下版本升级至 4.x 版本。 - Web SDK 4.x 是一个**不向下兼容**的版本,和 3.x 版本在 API 和产品行为上有较大变更,升级时建议参考声网提供的文档和示例项目。 - 在 Web SDK 4.x 中直播场景下,用户角色切换和轨道的发布解耦,调用 `publish` 和 `unpublish` 不会自动切换用户角色。详见[迁移实例详解](#publish)。 ::: ## 优势介绍 [#优势介绍] 本节详细介绍 Web SDK 4.x 版本相对于 3.x 版本的主要优势。 ### 异步方法均返回 Promise [#异步方法均返回-promise] 对于加入和离开频道、发布和订阅、获取媒体设备、开启和关闭转码推流等异步方法,在 Web SDK 3.x 中,通过回调函数(比如加入房间)、事件通知(比如发布/订阅)等方式来通知用户异步操作的结果;在 Web SDK 4.x 中,统一使用 Promise。 ### 基于音视频轨道的媒体控制 [#基于音视频轨道的媒体控制] 在 Web SDK 4.x 中,我们移除了 `Stream` 对象,取而代之的是 `Track` 轨道对象。一个音视频流是由多个音视频轨道构成的。你不直接创建、发布或订阅一个流,而是通过创建、发布或订阅一个或多个轨道来实现媒体管理。这样实现的好处是音视频的逻辑互不干扰、各自独立,同时新方法也比 Web SDK 3.x 的 `Stream.addTrack` 和 `Stream.removeTrack` 更方便易用。 Web SDK 4.x 允许同时发布多个音频轨道,SDK 会自动混音,但是视频轨道只允许同时发布一个。 除了把 `Stream` 拆分成 `Track`,在 Web SDK 4.x 中还区分 `RemoteTrack` 和 `LocalTrack`,有些方法和对象只适用于本地音视频轨道,有些只适用于远端音视频轨道。 这一改动影响多个 API 的使用,包括创建本地媒体对象、发布和订阅音视频,详见下文迁移实例详解中的[通过本地摄像头和麦克风采集音频和视频](#通过本地摄像头和麦克风采集音频和视频)和[发布本地的音视频](#发布本地的音视频)。 ### 改进频道内事件通知机制 [#改进频道内事件通知机制] **更改事件名** 在 Web SDK 4.x 中,我们统一了事件名。举例来说,原来的 Token 过期事件 `onTokenPrivilegeWillExpire` 更名为 `token-privilege-will-expire`。我们还调整了一些事件名以便它可以更好地被理解,比如 `peer-online` 和 `peer-offline` 更名为 `user-joined` 和 `user-left`,`stream-added` 和 `stream-removed` 更名为 `user-published` 和 `user-unpublished`。详见下文[核心 API 改动](#核心-api-改动)。 **调整事件回调携带参数的格式** Web SDK 3.x 的事件回调如果需要携带多个参数,会把这些参数统一包在一个对象中,但是 Web SDK 4.x 会直接携带多个参数到回调函数中。 以 "connection-state-change" 事件为例: ```javascript // 使用 Web SDK 3.x client.on("connection-state-change", e => { console.log("current", e.curState, "prev", e.prevState); }); ``` ```javascript // 使用 Web SDK 4.x client.on("connection-state-change", (curState, prevState) => { console.log("current", curState, "prev", prevState); }); ``` **改进频道内事件通知机制** Web SDK 4.x 改进了频道内事件通知机制,确保客户端**不会收到重复的**频道内状态通知事件。 假设**本地用户 A** 和**远端用户 B、C、D** 同时加入了一个频道,B、C、D 均发布了流。如果本地用户 A 发生了网络波动,和频道暂时失去了连接,SDK 会自动帮 A 重连,**在重连过程中 B 离开了频道,C 取消了发流**。这整个过程中,触发了哪些频道事件? 首先在 A 首次加入频道时,两个版本的 SDK 事件行为都是一致的,A 会收到: - 用户 B、C、D 加入频道的事件。 - 用户 B、C、D 发流的事件。 当 A 由于网络问题和频道暂时失去了连接,然后重连: - 如果 A 使用的是 Web SDK 3.x,当 SDK 和频道失去连接时,无论是否可以重连, SDK 都会认为 A 已经离开频道并清空频道内的所有状态。所以 A 重连回频道和 A 第一次加入频道时没有区别,会收到: - 用户 C、D 加入频道的事件。 - 用户 D 发流的事件。 - 如果 A 使用的是 Web SDK 4.x,当 SDK 和频道失去连接时,SDK 会认为 A 此时还在频道中,不会清空频道内的状态(用户主动调用 `leave` 离开频道除外)。所以当 A 重连回频道时,SDK 只会向 A 发送那些在重连过程中丢失的事件,包括: - 用户 B 退出频道的事件。 - 用户 C 取消发流的事件。 在 Web SDK 3.x 中,你会因为偶然发生的断线重连而收到重复的事件,这可能会导致你在上层事件处理时引发一些预期之外的问题。你需要监听连接状态变化,在断线重连时重置一些应用层的状态,以避免第二次收到这些事件时引发问题。而在 Web SDK 4.x 中,即使你没有像使用 Web SDK 3.x 时那样在断线重连时做一些特殊的逻辑,SDK 也能够确保你的上层应用可以正常工作,不会收到重复的事件。 简单来说,Web SDK 4.x 中的事件通知机制**更符合人类直觉**,你不需要像使用 Web SDK 3.x 时那样做一些额外的工作。 ## 迁移实例详解 [#迁移实例详解] 本节以一个多人通话应用为例,比对 Web SDK 4.x 和 Web SDK 3.x 在使用上的差别。 ### 加入频道 [#加入频道] 首先,创建一个 `Client` 对象,然后加入目标频道: ```javascript // 使用 Web SDK 3.x const client = AgoraRTC.createClient({ mode: "live", codec: "vp8" }); client.init("APPID", () => { client.join("Token", "Channel", null, (uid) => { console.log("join success", uid); }, (e) => { console.log("join failed", e); }); }); ``` ```javascript // 使用 Web SDK 4.x const client = AgoraRTC.createClient({ mode: "live", codec: "vp8" }); try { const uid = await client.join("APPID", "Channel", "Token", uid); console.log("join success"); } catch (e) { console.log("join failed", e); } ``` :::info[信息] 我们假设代码运行在一个 `async` 函数下,以下 Web SDK 4.x 相关示例代码为了叙述方便都会直接使用 `await`。 ::: 改动点: - 在 Web SDK 4.x 中,异步操作 `join` 返回 `Promise`,配合 `async/await` 使用。 - Web SDK 4.x 移除了 `client.init`, 在 `client.join` 时传入 `APPID`,这意味你可以使用一个 Client 对象先后加入不同 App ID 的频道。 ### 通过本地摄像头和麦克风采集音频和视频 [#通过本地摄像头和麦克风采集音频和视频] 通过本地麦克风采集的音频创建音频轨道对象,通过本地摄像头采集的视频创建视频轨道对象。示例代码中,默认播放本地视频,不播放本地音频。 ```javascript // 使用 Web SDK 3.x const localStream = AgoraRTC.createStream({ audio: true, video: true }); localStream.init(() => { console.log("init stream success"); localStream.play("DOM_ELEMENT_ID", { muted: true }); }, (e) => { console.log("init local stream failed", e); }); ``` ```javascript // 使用 Web SDK 4.x const localAudio = await AgoraRTC.createMicrophoneAudioTrack(); const localVideo = await AgoraRTC.createCameraVideoTrack(); console.log("create local audio/video track success"); localVideo.play("DOM_ELEMENT_ID"); ``` 改动点: - Web SDK 4.x 移除了 `Stream` 对象。采集麦克风和采集摄像头现在是两个独立的方法,分别返回音频轨道对象和视频轨道对象。 - Web SDK 4.x 中的音视频对象没有 `init` 方法,因为在创建音视频对象时 SDK 会初始化摄像头和麦克风,并通过 Promise 返回异步操作的结果。 - 由于在 Web SDK 4.x 中音视频对象分开控制,`play` 方法中移除了 `muted` 参数。如不想播放音频,不调用音频轨道中的 `play` 即可。 #### 发布本地的音视频 [#发布本地的音视频] 音视频采集完成后,将这些音视频发布到频道中。 ```javascript // 使用 Web SDK 3.x client.publish(localStream, err => { console.log("publish failed", err); }); client.on("stream-published", () => { console.log("publish success"); }); ``` ```javascript // 使用 Web SDK 4.x try { // 如果使用通信场景,则不需要这一行 await client.setClientRole("host"); await client.publish([localAudio, localVideo]); console.log("publish success"); } catch (e) { console.log("publish failed", e); } ``` 改动点: - 如果你的频道场景为直播场景,请注意以下行为变更: - 在 Web SDK 3.x 中,调用 `publish` 时 SDK 会自动将你的用户角色设为 `host`;但是在 Web SDK 4.x 中,你必须先调用 `setClientRole` 将用户角色设为 `host` 后再调用 `publish`。 - 在 Web SDK 3.x 中,主播调用 `unpublish` 取消发布流后,用户角色会自动切换为观众;但是在 Web SDK 4.x 中,主播取消发布流之后,用户角色不会自动切换为观众。如需将用户角色切换为观众,必须调用 `setClientRole`。 - 在 Web SDK 4.x 中,异步操作 `join` 返回 `Promise`。 - 在 Web SDK 4.x 中,调用 `publish` 时传入的参数是 `LocalTrack` 列表而非 `Stream`。可以重复调用 `publish` 来增加需要发布的轨道,或者重复调用 `unpublish` 来取消发布轨道。 ### 订阅远端音视频并播放 [#订阅远端音视频并播放] 如果频道里的远端用户发布了音视频轨道,你需要订阅这个用户并播放音视频轨道。在加入频道之前,你需要监听远端用户发布的相关事件,然后在收到事件回调时发起订阅。 ```javascript // 使用 Web SDK 3.x client.on("stream-added", e => { client.subscribe(e.stream, { audio: true, video: true }, err => { console.log("subscribe failed", err); }); }); client.on("stream-subscribed", e => { console.log("subscribe success"); e.stream.play("DOM_ELEMENT_ID"); }); ``` ```javascript // 使用 Web SDK 4.x client.on("user-published", async (remoteUser, mediaType) => { await client.subscribe(remoteUser, mediaType); if (mediaType === "video" || mediaType === "all") { console.log("subscribe video success"); remoteUser.videoTrack.play("DOM_ELEMENT_ID"); } if (mediaType === "audio" || mediaType === "all") { console.log("subscribe audio success"); remoteUser.audioTrack.play(); } }); ``` 改动点: - Web SDK 4.x 移除了 `stream-added`、`stream-removed` 和 `stream-updated`,取而代之的是 `user-published` 和 `user-unpublished`。 :::info[信息] 注意 `user-published` 回调中的第二个参数 `mediaType`,该参数有 3 个可能的值:`"video"`,`"audio"` 和 `"all"`。在我们的示例代码中,远端同时发布了音视频,所以 `mediaType` 理应为 `"all"`。但是在实际情况中,由于网络和发送端的不确定性,订阅端可能先收到一次 `user-published(mediaType: "audio")`,再收到一次 `user-published(mediaType: "video")`。因此在我们的示例代码中,我们做了一个简单的判断来处理这种情况。更多信息详见 [`client.on("user-published")`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#event_user_published)。 ::: - Web SDK 4.x 中,`subscribe` 是异步操作,会返回 Promise。传入的参数为 `remoteUser`,也就是远端用户对象,详见 [`AgoraRTCRemoteUser`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcremoteuser)。 - 远端音视频轨道对象会在订阅操作成功后保存在 `remoteUser` 下,直接调用 play 即可播放。 ## 核心 API 改动 [#核心-api-改动] 本节介绍 Web SDK 4.x 版本相对于 3.x 版本的核心 API 改动。 ### AgoraRTC [#agorartc] - `getScreenSources` 更名为 [`getElectronScreenSources`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#getelectronscreensources),并且移除了回调参数,现在会返回一个 Promise。 - [`getDevices`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#getdevices) 现在会返回一个 Promise,同时新增 [`getCameras`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#getcameras) 和 [`getMicrophones`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#getmicrophones)。 - 移除 `Logger` 对象,增加 [`disableLogUpload`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#disablelogupload)、[`enableLogUpload`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#enablelogupload) 和 [`setLogLevel`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#setloglevel) 用于控制日志上报和打印行为。 - 移除 `createStream`,新增以下方法创建音视频对象: - [`createMicrophoneAudioTrack`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#createmicrophoneaudiotrack): 创建麦克风轨道 - [`createCameraVideoTrack`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#createcameravideotrack): 创建摄像头轨道 - [`createScreenVideoTrack`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#createscreenvideotrack): 创建屏幕共享轨道 - [`createBufferSourceAudioTrack`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#createbuffersourceaudiotrack): 创建音频文件轨道(用于混音) - [`createCustomAudioTrack`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#createcustomaudiotrack) 和 [`createCustomVideoTrack`](/zh-CN/api-reference/rtc/web/interfaces/iagorartc#createcustomvideotrack): 创建自定义音视频轨道(用于自采集) ### Client [#client] - 移除 `Client.init` - 移除 `Client.getConnectionState`,新增 [`Client.connectionState`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#connectionstate) 字段表示当前和服务器的连接状态 - [`ConnectionState`](/zh-CN/api-reference/rtc/web/globals#connectionstate) 中新增状态 `RECONNECTING` 表示当前正在重连,原来的 `CONNECTING` 仅表示首次正在建立连接 - 新增 [`Client.uid`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#uid) 来表示当前本地用户的用户 ID - 新增 [`Client.remoteUsers`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#remoteusers) 来表示当前远端用户的用户列表 - 移除 `Client.on("streamInjectStatus")` - 移除 `Client.removeInjectStream` 的 `url` 参数 - 移除 [`Client.enableDualStream`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#enabledualstream) 和 [`Client.disableDualStream`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#disabledualstream) 的回调参数,现在会返回 Promise - 移除 `Client.getCameras`, `Client.getDevices`, `Client.getRecordingDevices`, 现在这些方法被移动到 `AgoraRTC` 下 - 移除 `Client.getPlayoutDevices` - 移除 `Client.getLocalAudioStats`、`Client.getLocalVideoStats`、`Client.getRemoteAudioStats`、`Client.getRemoteVideoStats`,现在音视频媒体统计数据统一通过 [`LocalAudioTrack.getStats`](/zh-CN/api-reference/rtc/web/interfaces/ilocalaudiotrack#getstats)、[`LocalVideoTrack.getStats`](/zh-CN/api-reference/rtc/web/interfaces/ilocalvideotrack#getstats)、[`RemoteAudioTrack.getStats`](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack#getstats)、[`RemoteVideoTrack.getStats`](/zh-CN/api-reference/rtc/web/interfaces/iremotevideotrack#getstats) 这些方法来获取,同时字段都做了改变,具体参阅 API 文档 - 移除 `Client.getSystemStats` - 移除 `Client.getSessionStats` 和 `Client.getTransportStats`,现在使用一个方法统一获取这些状态 [`Client.getRTCStats`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#getrtcstats) - [`Client.join`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#join) 现在会返回一个 Promise,移除回调参数,增加 `appid` 参数 - [`Client.leave`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#leave) 现在会返回一个 Promise,移除回调参数 - 增加 [`Client.once`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#once) 只监听目标事件一次 - 增加 [`Client.removeAllListeners`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#removealllisteners) 用于删除所有事件监听 - [`Client.publish`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#publish) 现在需要传入 [`LocalTrack`](/zh-CN/api-reference/rtc/web/interfaces/ilocaltrack) 的列表,现在会返回一个 Promise,同时移除 `Client.on("stream-published")` 回调。 - [`Client.unpublish`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#publish) 现在会返回一个 Promise - [`Client.subscribe`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#subscribe) 现在使用 [`AgoraRTCRemoteUser`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcremoteuser) 作为参数,返回一个 Promise,移除 `Client.on("stream-subscribed")` - [`Client.unsubscribe`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#unsubscribe) 现在使用 [`AgoraRTCRemoteUser`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcremoteuser) 作为参数,返回一个 Promise - [`Client.renewToken`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#renewtoken) 现在会返回一个 Promise - [`Client.setClientRole`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#setclientrole) 移除回调参数,现在会返回一个 Promise。**设置角色为 `audience` 后 SDK 不会自动 `unpublish`,调用 `publish` 时也不会自动把角色设置成 `host`** - 移除 `Client.setEncryptionMode` 和 `Client.setEncryptionSecret`,现在通过一个方法 [`Client.setEncryptionConfig`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#setencryptionconfig) 来配置 - [`Client.setLiveTranscoding`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#setlivetranscoding)、[`Client.startLiveStreaming`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#startlivestreaming) 和 [`Client.stopLiveStreaming`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#stoplivestreaming) 现在都会返回 Promise,同时移除 `Client.on("liveTranscodingUpdated")`、`Client.on("liveStreamingStarted")`、`Client.on("liveStreamingFailed")` 和 `Client.on("liveStreamingStopped")` 事件 - [`Client.startChannelMediaRelay`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#startchannelmediarelay) 现在会返回一个 Promise - [`ChannelMediaRelayConfiguration`](/zh-CN/api-reference/rtc/web/interfaces/ichannelmediarelayconfiguration) 移除 `setDestChannelInfo`, 改为 [`addDestChannelInfo`](/zh-CN/api-reference/rtc/web/interfaces/ichannelmediarelayconfiguration#adddestchannelinfo) 并去除冗余参数,具体参考 API 文档 - [`ChannelMediaRelayConfiguration`](/zh-CN/api-reference/rtc/web/interfaces/ichannelmediarelayconfiguration) 去除了 [`setSrcChannelInfo`](/zh-CN/api-reference/rtc/web/interfaces/ichannelmediarelayconfiguration#setsrcchannelinfo) 的冗余参数 - [`Client.stopChannelMediaRelay`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#stopchannelmediarelay) 现在会返回一个 Promise - [`Client.updateChannelMediaRelay`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#updatechannelmediarelay) 移除回调参数,现在会返回一个 Promise - 移除 `Client.on("first-video-frame-decode")` 和 `Client.on("first-audio-frame-decode")`,现在这两个事件通过 [`RemoteTrack.on("first-frame-decode")`](/zh-CN/api-reference/rtc/web/interfaces/iremotetrack#event_first_frame_decoded) 触发 - 移除 `Client.on("active-speaker")` 事件,相同的功能由 [`Client.on("volume-indicator")`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#event_volume_indicator) 提供 - `Client.on("onTokenPrivilegeWillExpire")` 和 `Client.on("onTokenPrivilegeDidExpire")` 更名为 [`Client.on("token-privilege-will-expire")`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#event_token_privilege_will_expire) 和 [`Client.on("token-privilege-did-expire")`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#event_token_privilege_did_expire) - 移除 `Client.on("network-type-changed")` 事件, SDK 无法保证其可靠性 - 移除 `Client.on("connected")` 和 `Client.on("reconnect")` 事件,连接状态事件统一从 [`Client.on("connection-state-change")`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#event_connection_state_change) 获取 - [`Client.on("stream-fallback")`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#event_stream_fallback) 参数修改,增加 `isFallbackOrRecover` 参数,详见 API 文档 ### Stream [#stream] Web SDK 4.x 以 Track 轨道对象取代 3.x 的 `Stream` 对象。一个音视频流是由多个音视频轨道构成的。你可以通过创建、发布或订阅一个或多个轨道来实现媒体管理。音视频的逻辑互不干扰、各自独立。此外,Web SDK 4.x 中还区分 `RemoteTrack` 和 `LocalTrack`,有些方法和对象只适用于本地音视频轨道,有些只适用于远端音视频轨道。 下面列出 4.x 和 3.x 在音视频控制上差异较大的几个功能: - 启用或禁用本地音视频:4.x 以 [`ILocalTrack.setEnabled`](/zh-CN/api-reference/rtc/web/interfaces/ilocalaudiotrack#setenabled) 取代 3.x 的 `Stream.muteAudio` 和 `Stream.muteVideo`,用于实现启用或禁用本地轨道。有以下行为变更: - 在 3.x 中,Mute 状态发生改变后 SDK 会触发 `Client.on("mute-audio")`、`Client.on("mute-video")`、`Client.on("unmute-audio")` 或 `Client.on("unmute-video")` 回调;4.x 中移除了上述回调,如果该本地轨道已发布,`setEnabled(false)` 后远端会触发 `Client.on("user-unpublished")`,`setEnabled(true)` 后远端会触发 `Client.on("user-published")`。 - 在 3.x 中,调用 `Stream.muteVideo(true)` 禁用本地视频流后,摄像头的指示灯并不会关闭,因而影响用户体验。在 4.x 中,调用 `setEnabled(false)` 禁用本地视频轨道后,SDK 会立刻关闭摄像头。 - 设置媒体设备: - 4.x 以 [`IMicrophoneAudioTrack.setDevice`](/zh-CN/api-reference/rtc/web/interfaces/imicrophoneaudiotrack#setdevice) 和 [`ICameraVideoTrack.setDevice`](/zh-CN/api-reference/rtc/web/interfaces/icameravideotrack#setdevice) 取代 3.x 的 `Stream.switchDevice`,用于设置媒体输入设备。 - 4.x 以 [`IRemoteAudioTrack.setPlaybackDevice`](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack#setplaybackdevice) 取代 3.x 的 `Stream.setAudioOutput`,用于设置音频输出设备。