# @azure/communication-react 中文文档

规范地址：https://npmcn.com/package/%40azure/communication-react/

版本：2\.0\.0
npm 元数据更新时间：2026-10-07T19:51:29.751Z
中文译文更新时间：2026-11-07T13:46:29.294Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40azure/communication-react
原文对照：https://npmcn.com/package/%40azure/communication-react/?lang=original
项目主页：https://azure.github.io/communication-ui-library/
源码仓库：https://github.com/Azure/communication-ui-library

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：17.4 MB，1849 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：30 个
- peer 依赖：react \>=16\.8\.0 \<19\.0\.0，react-dom \>=16\.8\.0 \<19\.0\.0，@types/react \>=16\.8\.0 \<19\.0\.0，@types/react-dom \>=16\.8\.0 \<19\.0\.0，@azure/communication-chat \>=1\.6\.0，@azure/communication-calling ^2\.0\.0，@azure/communication-calling-effects ^1\.3\.2
- 首次发布：2021-05-24T16:19:33.202Z
- 最新版本发布：2026-10-07T19:51:29.488Z
- 近 30 天下载量：56323（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：1087（近 12 个月 6 个）

## 中文简介

利用Azure通信服务建立现代通信用户经验的反应图书馆

## 安装

```sh
npm install @azure/communication-react
```

也可以使用：`pnpm add @azure/communication-react`、`yarn add @azure/communication-react`、`bun add @azure/communication-react`

## README

# @ Azure/ 通讯反应

`@Azure/communication-react` 是反应库,方便您使用 [Azure通信服务](https://azure.microsoft.com/services/communication-services/)。它会给您一个由反应组件组成的库,这些组件建在 [流利的UI](https://developer.microsoft.com/fluentui#/) 您可以在申请中输入.

更多信息,请访问Azure通信服务-UI图书馆 [这里](https://aka.ms/acsstorybook)。 。 。 .

## 先决条件

-   一个Azure账户, 活动订阅 . [免费创建账户](https://azure.microsoft.com/free/?WT.mc_id=A261C142F)。 。 。 .
-   活跃的通信服务资源. [创建通信服务资源](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp)。 。 。 .
-   [节点.js(16.19.0和以上)](https://nodejs.org/)

## 安装

`@azure/communication-react` 是反应库。 它需要合理的反应环境,支持到回放18. 我们建议使用Vite [从零创建反应应用程序](https://react.dev/learn/build-a-react-app-from-scratch) 财务报告和审定财务报表 [用 Vite 创建您的第一个工程](https://vite.dev/guide/#scaffolding-your-first-vite-project) 或类似工具来初始化您的应用程序.

```bash
npm i @azure/communication-react
```

`@azure/communication-react` 指定核心Azure通信服务为 `peerDependencies` 这样 您可以在应用程序中最一致地使用来自核心库的 API。 您还需要安装这些库:

```bash
npm i @azure/communication-calling
npm i @azure/communication-chat
```

## 故事书

对于完整的文档、快速启动和交互式组件,请检查我们 [故事书](https://aka.ms/acsstorybook)。 。 。 .

## 常见问题

### @azure/communication-react 是什么？

利用Azure通信服务建立现代通信用户经验的反应图书馆

### 如何安装 @azure/communication-react？

在项目目录运行 npm install @azure/communication-react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=16\.8\.0 \<19\.0\.0）、react-dom（\>=16\.8\.0 \<19\.0\.0）、@types/react（\>=16\.8\.0 \<19\.0\.0）、@types/react-dom（\>=16\.8\.0 \<19\.0\.0）、@azure/communication-chat（\>=1\.6\.0）、@azure/communication-calling（^2\.0\.0）、@azure/communication-calling-effects（^1\.3\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @azure/communication-react 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @azure/communication-react 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @azure/communication-react 可以商用吗？

@azure/communication-react 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @azure/communication-react 的下载量有多少？

根据 npm 官方下载统计，@azure/communication-react 在 2026/10/08 – 2026/11/06 这 30 天内被下载 56,323 次，日均约 1,877 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @azure/communication-react 还在维护吗？

最新版本 2\.0\.0 发布于 2026/10/08（1 个月前）；至今共发布 1087 个版本，其中过去 12 个月发布了 6 个；首次发布于 2021/05/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。