输入关键词搜索,支持 AI 答疑

跑通示例项目

更新时间: 2024/08/14 11:41:36

网易云信为您提供 1 对 1 娱乐社交场景的开源示例项目,您可以参考本文档快速跑通示例项目,体验 1 对 1 娱乐社交场景的最佳效果。

开发环境

在开始运行示例项目之前,请确保开发环境满足以下要求:

环境要求 说明
Android Studio 版本 Android Studio 5.0 及以上版本 Android Studio 版本编号系统的变更请参考 Android Studio 版本说明
Android API 版本 Level 为 21 及以上版本。
Android SDK 版本 Android SDK 31、Android SDK Platform-Tools 31.x.x 及以上版本。
Gradle 及所需的依赖库 Gradle Services 页面下载对应版本的 Gradle 及所需的依赖库。
  • Gradle 版本:7.4.1
  • Android Gradle 插件版本: 7.1.3
    关于 Android Gradle 插件、Gradle、SDK Tool 之间的版本依赖关系,请参见 Android Gradle 插件版本说明
CPU架构 ARM 64、ARMV7
IDE Android Studio
其他 依赖 Androidx,不支持 support 库。
Android 系统 5.0 及以上版本的真机。由于模拟器缺少摄像头及麦克风能力,因此工程需要在真机运行。

前提条件

请确认您已完成以下操作:

运行示例项目

  • 1 对 1 娱乐社交的示例源码仅供开发者接入参考,实际应用开发场景中,请结合具体业务需求修改使用。

  • 若您计划将源码用于生产环境,请确保应用正式上线前已经过全面测试,以免因兼容性等问题造成损失。

  • 以下源码跑通无须部署服务端即可体验,请按照以下步骤设置客户端源码配置。

  1. 克隆 示例项目源码 仓库至您本地工程。

  2. 通过 Android Studio 打开项目。

    在菜单栏中选择 File > Open,选择示例项目源码仓库(1V1/Android)所在目录。

  3. /app/java/com.netease.yunxin.app.oneonone/config/AppConfig.java 文件中配置应用的 AppKey 和 AppSecret。

    private static final String APP_KEY = "your AppKey"; // 请填写应用对应的AppKey,可在云信控制台的”AppKey管理“页面获取
    public static final String APP_SECRET = "your AppSecret"; // 请填写应用对应的AppSecret,可在云信控制台的”AppKey管理“页面获取
    public static final boolean IS_OVERSEA = false; // 如果您的AppKey为海外,填ture;如果您的AppKey为中国国内,填false
    /**
     * 默认的BASE_URL地址仅用于跑通体验Demo,请勿用于正式产品上线。在产品上线前,请换为您自己实际的服务端地址
    */
    public static final String BASE_URL = "https://yiyong.netease.im/";   //云信派对服务端国内的体验地址
    public static final String BASE_URL_OVERSEA = "https://yiyong-sg.netease.im/";   //云信派对服务端海外的体验地址
    
    • 获取 AppKey 和 AppSecret 的方法请参见创建应用并获取 AppKey
    • BASE_URL 地址 https://yiyong.netease.im和 BASE_URL_OVERSEA地址https://yiyong-sg.netease.im为云信派对服务端体验地址,该地址仅用于体验 Demo,单次体验时长最长为 1 小时,请勿用于生产环境
    • 如果您的 AppKey 为海外,IS_OVERSEA 请设置为 true

    配置AppKey.png

  4. 在 Android Studio 中,单击 Sync Project with Gradle Files 按钮SyncProjectwithGradleFiles.png,同步工程依赖。

  5. 运行工程。

    1. 开启 Android 设备的开发者模式USB 调试功能。将 Android 设备连接到开发电脑,在弹出的授予调试权限对话框中,授予调试权限,具体步骤请参见在硬件设备上运行应用

      Android Studio 菜单栏中的 Running Devices 下拉列表选项,由 No Devices变为对应的设备名称。

      noDevice.png

      RunningDevices.png

      此时表示设备已成功连接到 Android Studio。

    2. 单击 Run 按钮run按钮.png,编译并运行示例源码。

    • 建议在真机上运行,不支持模拟器调试。
    • 请使用两个手机运行工程,Demo 上才能显示用户列表,体验 1 对 1 聊天等功能。

示例项目结构

目录 描述
app App模块
beauty 美颜
oneonone 1对1业务
entertainment 通用工具类
oneonone核心目录结构
├── activity    
│   ├── BaseActivity.java  基础Activity
│   ├── CallActivity.java  呼叫&&通话页
│   ├── CustomChatP2PActivity.java   自定义11聊天页
│   ├── OneOnOneHomeActivity.java   11首页
├── constant
│   ├── AppParams.java       App参数
│   ├── AppRtcConfig.java    Rtc参数
│   ├── CallConfig.java      呼叫参数
│   ├── Constants.java       常量
├── custommessage     
│   ├── AccostMessageAttachment.java   IM自定义消息-搭讪
│   ├── AccostMessageViewHolder.java   IM自定义UI-搭讪 
│   ├── AssistantAttachment.java       IM自定义消息-小秘书
│   ├── AssistantMessageViewHolder.java  IM自定义UI-小秘书
│   ├── CommonRiskAttachment.java         IM自定义消息-风险提醒
│   ├── CommonRiskMessageViewHolder.java  IM自定义UI-风险提醒
│   ├── GiftAttachment.java            IM自定义消息-礼物
│   ├── GiftMessageViewHolder.java     IM自定义UI-礼物
│   ├── OneOnOneChatCustomMessageType.java  IM自定义消息类型常量
│   ├── PrivacyRiskAttachment.java          IM自定义消息-隐私泄漏提醒 
│   ├── PrivacyRiskMessageViewHolder.java   IM自定义UI-隐私泄漏提醒 
│   ├── TryAudioCallMessageAttachment.java  IM自定义消息-尝试音频通话 
│   ├── TryAudioCallMessageViewHolder.java  IM自定义UI-尝试音频通话 
│   ├── TryVideoCallMessageAttachment.java  IM自定义消息-尝试视频通话
│   └── TryVideoCallMessageViewHolder.java  IM自定义UI-尝试视频通话
├── dialog
│   ├── AudioInputDialog.java    语音输入弹窗
│   ├── ContactUserDialog.java   联系对方弹窗
├── fragment
│   ├── CallFragment.java              呼叫页
│   ├── HomeFragment.java              首页 
│   ├── InTheAudioCallFragment.java    音频通话中
│   ├── InTheBaseCallFragment.java     音视频通话中Base 
│   ├── InTheVideoCallFragment.java    视频通话中
│   ├── MessageFragment.java           消息列表
├── http
│   ├── HttpService.java               网络服务 
│   └── ServerApi.java                 网络Api
├── utils

│   ├── AudioInputManager.java         语音输入
│   ├── ChatUIConfigManager.java       IM UIKit自定义配置
│   ├── IMUIKitUtil.java               IM UIKIT初始化工具类
│   ├── SecurityAuditManager.java      音视频通话安全通管理类
└── viewmodel
    ├── CallViewModel.java             音视频通话ViewModel
    ├── CustomP2PViewModel.java        11消息ViewModel

常见问题

1. 手机连接电脑后,Android Studio 中没有出现对应的手机

如果 Android 设备连接电脑后,Android Studio 的 Running Devices 中没有出现对应的手机,可能原因如下:

  • 您的数据线不支持连接存储。

  • 电脑没有安装对应的驱动。请参考下图,安装和您的 Android 设备匹配的驱动。

    Google_USB_driver.png

  • Android 设备没有开启开发者模式USB 调试,或者连接手机时,在弹出的授予调试权限对话框中,没有授予权限。

此文档是否对你有帮助?
有帮助
去反馈
  • 开发环境
  • 前提条件
  • 运行示例项目
  • 示例项目结构
  • 常见问题