# 发布和订阅 (/zh-CN/realtime-media/rtc/build/initialize-and-channel/publish-subscribe)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

## 发布音视频 [#发布音视频]

本文详细介绍如何使用声网 Web SDK 发布和取消发布本地音视频，以及订阅和取消订阅远端音视频。

完成本地轨道的创建并且成功加入频道后，就可以调用 [`AgoraRTCClient.publish`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#publish) 将本地的音视频数据发布到当前频道，以供频道中的其他用户订阅。

```javascript
const localAudioTrack = ...;
const localVideoTrack = ...;

// 你可以多次调用 publish 发布多个轨道
await client.publish(localAudioTrack);
await client.publish(localVideoTrack);

// 也可以一次性将需要发布的轨道一起发布
await client.publish([localAudioTrack, localVideoTrack]);
```

关于发布，注意事项如下：

- 同一时间只能发布一个视频轨道。
- 可以同时发布多个音频轨道，SDK 会自动混音（Safari 12 之前的版本不支持混音，无法使用此特性）。
- 可以多次调用该方法来发布不同的轨道，但是不能重复发布同一个轨道对象。
- 该方法为异步方法，使用时需要配合 `Promise` 或 `async/await`。

在发布过程中，可能因为网络环境或者 SDK 使用不当抛出以下错误：

- `INVALID_OPERATION`: 非法操作，说明在加入频道成功之前就调用了 `publish` 方法。
- `OPERATION_ABORTED`: 发布被中止，可能是因为在发布成功之前就主动调用 `leave` 离开了频道。
- `INVALID_LOCAL_TRACK`: 参数错误，传入了非法的 `LocalTrack` 对象。
- `CAN_NOT_PUBLISH_MULTIPLE_VIDEO_TRACKS`: 不允许同时发布多个视频轨道。
- `NOT_SUPPORTED`: 发布了多个音频轨道，但是浏览器不支持混音。
- `UNEXPECTED_RESPONSE`: 收到了声网服务器异常的返回，发布轨道失败。建议保留日志，联系声网[技术支持](https://ticket.shengwang.cn/)。
- `NO_ICE_CANDIDATE`: 找不到本地网络出口，可能是网络防火墙或者启用了禁止 WebRTC 的浏览器插件。详见[如何处理常见的 Web 浏览器控制台报错](/zh-CN/reference/faq/integration/console_error_web)。

## 取消发布音视频 [#取消发布音视频]

成功发布本地轨道后，如果想取消发布，可以调用 [`AgoraRTCClient.unpublish`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#unpublish)。

```javascript
// 发布音视频
await client.publish([localAudioTrack, localVideoTrack]);

// 取消发布视频，此时音频还在正常发布
await client.unpublish(localVideoTrack);

// 也可以一次将所有正在发布的轨道全部取消发布
await client.unpublish();
// 或者批量取消发布
await client.unpublish([localAudioTrack, localVideoTrack]);
```

关于取消发布，注意事项如下：

- 该方法可以多次调用。你可以使用 `publish` 和 `unpublish` 实现发布和取消发布某个本地轨道。
- 该方法为异步方法，使用时需要配合 `Promise` 或 `async/await`。

## 订阅音视频 [#订阅音视频]

当远端用户成功发布音视频轨道之后，SDK 会触发 [`user-published`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#event_user_published) 事件。这个事件携带两个参数：远端用户对象 (`user`) 和远端发布的媒体类型 (`mediaType`)。此时，你可以调用 [`AgoraRTCClient.subscribe`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#subscribe) 发起订阅。

该方法为异步方法，使用时需要配合 `Promise` 或者 `async/await`。

```javascript
client.on("user-published", async (user, mediaType) => {
  // 发起订阅
  await client.subscribe(user, mediaType);

  // 如果订阅的是音频轨道
  if (mediaType === "audio") {
    const audioTrack = user.audioTrack;
    // 自动播放音频
    audioTrack.play();
  } else {
    const videoTrack = user.videoTrack;
    // 自动播放视频
    videoTrack.play(DOM_ELEMENT);
  }
});
```

当订阅方法调用完成之后，你可以通过 `user.audioTrack` 和 `user.videoTrack` 获取相应的 [`RemoteAudioTrack`](/zh-CN/api-reference/rtc/web/interfaces/iremoteaudiotrack) 和 [`RemoteVideoTrack`](/zh-CN/api-reference/rtc/web/interfaces/iremotevideotrack) 对象。

订阅和发布不同，每次订阅只能订阅一个音频或视频轨道。即使发布端同时发布了音频轨道和视频轨道，SDK 也会触发两次 `user-published` 事件：一次 `user-published(audio)`，一次 `user-published(video)`。按照上面的代码逻辑，会完成两次订阅。

在订阅过程中，因为网络环境等因素 SDK 可能抛出如下错误：

- `INVALID_OPERATION`: 非法操作，可能在加入频道成功之前就调用了 `subscribe`。
- `INVALID_REMOTE_USER`: 传入了非法的远端用户对象，例如该用户不在频道内。
- `REMOTE_USER_IS_NOT_PUBLISHED`: 传入的远端用户没有发布 `subscribe` 方法中传入的媒体类型。
- `UNEXPECTED_RESPONSE`: 收到了声网服务器异常的返回，订阅失败。建议保留日志，联系声网[技术支持](https://ticket.shengwang.cn/)。
- `OPERATION_ABORTED`: 操作中止，可能在订阅成功之前就调用 `leave` 离开了频道。
- `NO_ICE_CANDIDATE`: 找不到本地网络出口，可能是网络防火墙或者启用了禁止 WebRTC 的浏览器插件。详见[如何处理常见的 Web 浏览器控制台报错](/zh-CN/reference/faq/integration/console_error_web#none-ice-candidate-not-alloweda-namecandidatea)。

## 取消订阅音视频 [#取消订阅音视频]

你可以通过 [`AgoraRTCClient.unsubscribe`](/zh-CN/api-reference/rtc/web/interfaces/iagorartcclient#unsubscribe) 取消订阅远端的音视频。

```javascript
// 订阅目标用户的音视频
await client.subscribe(user, "audio");
await client.subscribe(user, "video");

// 取消订阅视频
await client.unsubscribe(user, "video");
// 也可以取消订阅当前用户的所有媒体类型
await client.unsubscribe(user);
```

关于取消订阅，注意事项如下：

- 取消订阅成功后，SDK 会释放相应的 `RemoteTrack` 对象。一旦远端轨道对象被释放，SDK 会自动移除视频的播放元素，音频播放也会停止。
- 如果远端用户主动取消发布，本地会收到 `user-unpublished` 回调，收到该回调时 SDK 会自动释放相应的 `RemoteTrack` 对象，你无需再调用 `unsubscribe`。
- 该方法为异步方法，使用时需要配合 `Promise` 或 `async/await`。