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

开发环境

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

前提条件

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

• 已创建应用并获取 App Key

• 已开通IM 即时通讯、信令和音视频通话2.0

• 已配置RTC 和 IM 的消息抄送地址（抄送地址请填写http://yiyong.netease.im/nemo/socialChat/nim/notify）

  

运行示例项目

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

2. 通过 Android Studio 打开项目。

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

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

   javaprivate 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为海外，填true；如果您的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。

   

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

5. 运行工程。

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

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

      

      

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

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

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

示例项目结构

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

常见问题