跑通示例项目 - 1 对 1 娱乐社交

1 对 1 娱乐社交

开发者中心

1 对 1 娱乐社交

快速开始

跑通示例项目

更新时间： 2023/05/26 15:51:56

网易云信为您提供 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 及以上版本的真机。由于模拟器缺少摄像头及麦克风能力，因此工程需要在真机运行。

前提条件

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

注意事项

示例项目需要在 RTC 调试模式下使用，此时无需传入 Token。修改鉴权方式的方法请参见 Token 鉴权。

您可以在集成开发阶段使用调试模式进行应用开发与测试。但是出于安全考虑，应用正式上线前，请在控制台中将指定应用的鉴权方式改回安全模式。

运行示例项目

1 对 1 娱乐社交的示例源码仅供开发者接入参考，实际应用开发场景中，请结合具体业务需求修改使用。
若您计划将源码用于生产环境，请确保应用正式上线前已经过全面测试，以免因兼容性等问题造成损失。

克隆示例项目源码仓库至您本地工程。
通过 Android Studio 打开项目。

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

在 /app/java/com.netease.yunxin.app.oneonone/config/AppConfig.java 文件中配置应用的 App Key，并填写云信 IM 账号相关信息。

// 请填写您的appKey,如果您的APP是国内环境，请填写APP_KEY_MAINLAND，如果是海外环境，请填写APP_KEY_OVERSEA
public static final String ONLINE_APP_KEY = "your mainland appKey";// 国内用户填写
public static final String OVERSEA_APP_KEY = "your oversea appKey";// 海外用户填写
// 请填写1对1服务端工程返回的账号信息
public static final String IM_ACCID = "your im accid";
public static final String IM_TOKEN = "your im token";
public static final String IM_AVATAR = "your im avatar";
public static final String IM_NICKNAME = "your im nickname";
public static final String PHONE_NUMBER = "your phone number";
public static final String USER_TOKEN = "your user token";
// 跑通Server Demo后，替换为实际的host,默认是http://127.0.0.1:9981 需要连网络代理运行
public static final String BASE_URL="http://127.0.0.1:9981";

配置AppKey.png

在 Android Studio 中，单击 Sync Project with Gradle Files 按钮，同步工程依赖。
运行工程。
1. 开启 Android 设备的开发者模式和USB 调试功能。将 Android 设备连接到开发电脑，在弹出的授予调试权限对话框中，授予调试权限，具体步骤请参见在硬件设备上运行应用。
  
  Android Studio 菜单栏中的 Running Devices 下拉列表选项，由 No Devices变为对应的设备名称。
  
  此时表示设备已成功连接到 Android Studio。
2. 单击 Run 按钮，编译并运行示例源码。
建议在真机上运行，不支持模拟器调试。

示例项目结构

目录	描述
app	App模块
beauty	美颜
oneonone	1对1业务
entertainment	通用工具类

oneonone核心目录结构
├── activity    
│   ├── BaseActivity.java  基础Activity
│   ├── CallActivity.java  呼叫&&通话页
│   ├── CustomChatP2PActivity.java   自定义1对1聊天页
│   ├── OneOnOneHomeActivity.java   1对1首页
├── 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        1对1消息ViewModel

常见问题

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

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

您的数据线不支持连接存储。
电脑没有安装对应的驱动。请参考下图，安装和您的 Android 设备匹配的驱动。
Android 设备没有开启开发者模式和USB 调试，或者连接手机时，在弹出的授予调试权限对话框中，没有授予权限。

此文档是否对你有帮助？

有帮助

我要吐槽

文档反馈

在线咨询

开发环境要求
前提条件
注意事项
运行示例项目
示例项目结构
常见问题