更新记录

4.8.1（2026-07-09） 下载此版本

New Features

• uni-app UTS 插件 iOS 端支持 LiveCommunicationKit 系统来电横幅能力。接入方开启后，被叫可在后台、锁屏、杀进程拉起等场景通过 iOS 系统来电横幅接听或拒绝来电，并支持配置系统来电横幅铃声文件名。

• setup 新增参数：

  • liveCommunicationKitConfig.enabled — iOS 端开启 LiveCommunicationKit 系统来电横幅能力。
  • liveCommunicationKitConfig.ringtoneName — iOS 端配置 LiveCommunicationKit 系统来电横幅铃声文件名。

4.7.5（2026-06-18） 下载此版本

[4.7.5] - 2026-06-15

New Features

• 新增来电横幅能力：Android 和 iOS 支持在屏幕顶部展示来电横幅，用户可直接接听或拒绝，无需打开全屏来电界面。
• 新增来电横幅开关：
  • init({ enableIncomingBanner: true })：初始化时开启来电横幅模式。
  • uni.$NECallKit.enableIncomingBanner(enable)：运行时开启或关闭来电横幅。
• 新增通话中音视频切换能力：
  • uni.$NECallKit.switchAudioToVideo()：语音通话中发起切换为视频通话。
  • uni.$NECallKit.switchVideoToAudio()：视频通话中发起切换为语音通话。
  • uni.$NECallKit.setSwitchCallTypeConfirm(audioToVideoConfirm, videoToAudioConfirm)：配置语音转视频、视频转语音时是否展示确认弹窗。
• Android 新增通话中悬浮窗能力：
  • uni.$NECallKit.startFloatWindow()：通话中开启小窗。
  • uni.$NECallKit.stopFloatWindow()：关闭小窗并返回通话页。
• iOS 新增退后台自动画中画配置：
  • init({ enableAutoFloatingWindowWhenHome: true })：视频通话退后台时自动启动系统画中画。使用前需在 Xcode 工程开启 Background Modes -> Picture in Picture。

4.0.0（2025-12-08） 下载此版本

UTS版本首次发布，支持1V1音视频通话

平台兼容性

uni-app(3.7.13)

uni-app x(3.7.13)

其他

Netease-Call

本文将介绍如何快速体验音视频通话功能，您将在10分钟内完成以下关键步骤，并最终获得一个具有1V1通话界面的视频通话功能。

插件概述

网易云信音视频呼叫（Netease-Call）是网易云信推出的含 UI 组件，您只需要几行代码，就可以快速实现音视频呼叫，在 App 中添加包括呼叫、接通、拒接、以及通话中音频和视频的开关控制功能，并包含呼叫的 UI 界面。

呼叫组件基于云信信令、音视频通话 2.0 和 IM 即时通讯产品封装的融合性场景组件，简化了呼叫流程，将呼叫功能以 UI 组件化的形式提供给客户，提高接入效率、降低使用成本。

呼叫组件（Netease-Call）支持的功能如下表所示。

技术支持

网易云信提供多种服务，包括客服、技术支持、热线服务、全流程数据监控等，建议扫码添***们的技术支持，协助接入、测试以及定制需求。	微信咨询	在线咨询	电话咨询
	点击在线咨询	4009-000-123

功能开通

1. 申请 AppKey

用户在使用本插件之前需要获取AppKey，AppKey 申请的具体流程请参见 创建应用并获取AppKey。

2. 获取账号

本插件使用中需要 account 和 token，具体请参见 注册云信IM账号。

3. 开通服务

使用音视频呼叫（呼叫组件）之前，需要开通部分能力，开通的具体流程请参见 开通服务。

环境准备

说明：

Hbuilder x 4.64 和 4.65 版本对 uts 插件打包存在兼容性问题，建议使用最新版本。

• HBuilder X

• 两个移动设备： Android 5.0 以上的设备 / iOS 13.0 及以上设备。

快速接入

步骤一 : 下载 Demo

1. 从 github 下载 NECallKit Demo 源码，或者直接在命令行运行以下命令：

    https://github.com/netease-kit/NECallKit.git

2. 通过 HbuiderX 打开 NECallKit/uni-app/NECallkit-app-uts 项目：

   

步骤二 : 配置 Demo

将功能开通中的AppKey填写到 'NECallKit/uni-app/NECallKit-app-uts/config.js' 文件下的 appKey。

步骤三 : 跑通 Demo

1. 制作自定义调试基座，请选择传统打包方式进行打包。

2. 自定义调试基座成功后，使用自定义基座运行项目。

iOS 本地运行（内部开发）

如果需要在 uni-app UTS iOS 工程中验证本仓库 iOS 源码改动，可将 NERtcCallKit / NERtcCallUIKit 切换为本地依赖：

cd /Users/admin/Documents/WorkPro/NetEase/SourceCode/NECallKit
python3 .agents/skills/switch-uniapp-uts-ios-callkit-deps/scripts/switch_callkit_ios_deps.py local

本地模式会执行以下操作：

• 从 iOS/ 源码构建并复制 NERtcCallKit.xcframework、NERtcCallUIKit.xcframework 到 utssdk/app-ios/Frameworks。
• 构建时传入 --delete NERtcCallKit，避免 Swift interface 中出现 NERtcCallKit.NECallInfo 等错误前缀。
• NERtcCallKit / NERtcCallUIKit 的子依赖不放入 Frameworks，改为写入 utssdk/app-ios/config.json 的 dependencies-pods。

当前本地模式的 Pod 依赖包括：

[
  { "name": "NERtcSDK", "version": "5.9.10" },
  { "name": "NIMSDK_LITE", "version": "10.9.76" },
  { "name": "Masonry", "version": "1.1.0" },
  { "name": "NECommonKit", "version": "9.7.5" },
  { "name": "NECommonUIKit", "version": "9.8.2" },
  { "name": "NECoreKit", "version": "9.8.0" },
  { "name": "NEXKitBase", "version": "1.1.0" },
  { "name": "SDWebImage", "version": "5.21.0" }
]

切换后可检查状态：

python3 .agents/skills/switch-uniapp-uts-ios-callkit-deps/scripts/switch_callkit_ios_deps.py status

需要恢复线上 Pod 依赖时执行：

python3 .agents/skills/switch-uniapp-uts-ios-callkit-deps/scripts/switch_callkit_ios_deps.py online

注意：首次切换本地模式时脚本会保存当前线上 config.json 和 Frameworks 基线到 utssdk/app-ios/.callkit-deps-state/，用于后续恢复线上状态。

步骤四：拨打第一通电话

注意：

为了使您可以体验完整的音视频通话流程，请将 Demo 分别在两台设备上登录两个用户，一方作为主叫，一方作为被叫。

1. 获取账号（AccountId）和token

2. 登录

3. 拨打电话