跑通示例项目

更新时间: 2026/04/24 15:11:15

在视频呼叫示例项目中使用了呼叫组件实现音视频呼叫,适用于 Android、iOS、HarmonyOS、Windows、macOS 等多个平台。

本文介绍如何快速跑通音视频呼叫的示例项目,体验音视频呼叫功能。

开发环境

示例项目对开发环境的要求如下所示:

环境要求 说明
Dart >= 2.17.0 < 4.0.0
Flutter 2.5.0 及以上版本,并启用 macos/windows desktop 支持
JDK 版本 1.8.0 及以上版本
Android API 版本 API 21、Android 5.0 及以上版本
CPU 架构 ARM64、ARMV7
IDE/构建工具 推荐使用 Flutter 兼容 IDE
  • macOS 需安装 Xcode、CocoaPods,并具备可用的 cmake/ninja
  • Windows 需具备 Flutter Windows 桌面构建所需的 MSVC/CMake 工具链
设备要求
  • Android:运行 Android 系统 4.3 或以上版本的移动设备
  • iOS:iOS 13 及以上系统的设备
  • Windows:仓库自带 windows/ runner,当前 manifest 已声明 Windows 10/11
  • macOS:10.15 及以上,当前示例工程固定按 x86_64 构建,Apple Silicon 机器请按 x86_64 链路运行
  • 鸿蒙:5.0.0.102 或更高版本的手机设备
依赖 依赖 Androidx,不支持 support 库

前提条件

在开始运行示例项目之前,请确保您已完成以下操作:

  • 创建应用并获取应用的 App Key
  • 已开通以下服务,若未开通,请参考 开通服务 进行开通。
    • IM 即时通讯。当使用呼叫组件自带的话单功能时,需开通 IM。
    • 信令。用于实现点对点呼叫邀请以及音视频通话。
    • 音视频通话 2.0。用于实现实时音视频通话。
    • 如需要抄送,请提前开通消息抄送中的 话单 抄送服务,实现在一通通话结束后,发送事件通知消息,标记此次通话是否接通以及通话时间、类型等数据。

操作步骤

  • 示例源码仅供开发者接入参考,实际应用开发场景中,请结合具体业务需求修改使用。
  • 若您计划将源码用于生产环境,请确保应用正式上线前已经过全面测试,以免因兼容性等问题造成损失。
  • 示例代码中包含业务登录逻辑,如果您的业务中需要使用登录相关功能,请修改登录相关的逻辑。
  1. 克隆 示例项目源码

  2. 进入 NLiteAVDemo-Flutter 文件夹,其中 example 目录结构说明如下:

    Bash├── lib                                            Flutter 示例项目代码
    │   └── main.dart                                  入口(项目 UI、账号配置)
    ├── android                                        安卓工程代码
    ├── ios                                            iOS工程代码
    ├── macos                                          macOS工程代码
    ├── windows                                        Windows工程代码
    ├── ohos                                           鸿蒙工程代码
    
  3. 配置应用的 AppKey 及 AppSecret。

    lib/config/app_config.dart 文件中配置应用的 AppKey。

    // 请填写应用对应的 AppKey,可在云信控制台的”AppKey管理“页面获取
    static const String _appKey = "your appKey";
    // 请填写应用对应的 AppSecret,可在云信控制台的”AppKey管理“页面获取
    static const String _appSecret = "your sercet";
    

    获取 AppKey 和 AppSecret 的方法请参见获取 AppKey

  4. 在 example 工程根目录执行如下命令引入依赖。

    bashflutter pub get
    
  5. 在 IDE 环境中选中调试设备后,执行如下命令开始编译 Demo 项目:

    bashflutter run
    
此文档是否对你有帮助?
有帮助
去反馈
  • 开发环境
  • 前提条件
  • 操作步骤