返回

Agora SDK在Android中的应用：开启精彩的实时互动

Android

在 Android 应用中无缝集成 Agora SDK，开启实时互动盛宴

加入 Agora 大家庭，畅享实时互动体验

踏入移动和 Web 应用实时互动领域，Agora SDK 犹如一剂强心剂，助您轻而易举地为应用注入音视频通话、视频会议等实时互动元素。本指南将为您提供详细的分步说明，带领您在 Android 应用中无缝集成 Agora SDK，开启畅快的实时互动之旅。

注册账号，创建项目，开启您的 Agora 之旅

迈出第一步，访问 Agora 官网注册账号，并创建一个项目。在创建项目时，请为您的项目取一个响亮的名字，并选择合适的地区。

下载 Agora SDK，为您的应用注入实时互动能力

完成注册后，前往 Agora 官网的下载中心，下载适用于 Android 的 Agora SDK。

破解示例代码，解锁互动秘籍

Agora 为您精心准备了丰富的示例代码，涵盖了一对一视频通话、多人群组视频会议等各种实时互动场景。访问 Agora 开发者中心，下载这些示例代码，助您快速上手。

集成 Agora SDK，开启实时互动大门

  1. 添加依赖项： 将 Agora SDK 依赖项添加到应用的 build.gradle 文件中。
dependencies {
    implementation 'io.agora.rtc:full-sdk:3.4.3'
}
  1. 初始化 Agora SDK： 在应用的 onCreate() 方法中初始化 Agora SDK。
// 创建 Agora RtcEngine 对象
RtcEngine mRtcEngine = RtcEngine.create(this, "<YOUR_APP_ID>", new RtcEngineEventHandler() {
    // 处理 SDK 事件
});
  1. 加入或创建频道： 通过 joinChannel() 或 createChannel() 方法加入或创建频道。
// 加入频道
mRtcEngine.joinChannel(null, "<YOUR_CHANNEL_NAME>", 0, <YOUR_UID>);

// 创建频道
mRtcEngine.createChannel("<YOUR_CHANNEL_NAME>", <YOUR_UID>);
  1. 设置本地视图： 使用 SurfaceView 或 TextureView 来显示本地视频流。
// 创建 SurfaceView
SurfaceView localSurfaceView = findViewById(R.id.local_surface_view);

// 设置本地视图
mRtcEngine.setupLocalVideo(new VideoCanvas(localSurfaceView, VideoCanvas.RENDER_MODE_HIDDEN));
  1. 预览本地视频： 使用 startPreview() 方法开始预览本地视频。
// 开始预览本地视频
mRtcEngine.startPreview();
  1. 设置远端视图： 当其他用户加入频道时，Agora SDK 会触发 onJoinChannelSuccess() 事件。您可以在此事件中设置远端视图。
@Override
public void onJoinChannelSuccess(String channel, final int uid, int elapsed) {
    runOnUiThread(new Runnable() {
        @Override
        public void run() {
            // 创建 TextureView
            TextureView remoteSurfaceView = findViewById(R.id.remote_surface_view);

            // 设置远端视图
            mRtcEngine.setupRemoteVideo(new VideoCanvas(remoteSurfaceView, VideoCanvas.RENDER_MODE_HIDDEN));
        }
    });
}

自定义互动体验，打造个性化实时互动

除了基本功能，Agora SDK 还提供了丰富的 API，让您自由定制互动体验。

  • 控制麦克风和摄像头的开关
  • 设置音频和视频的分辨率和帧率
  • 添加背景音乐或音效
  • 使用美颜和滤镜功能

结语

通过集成 Agora SDK，您的 Android 应用将具备强大的实时音视频通话和会议功能。Agora SDK 的稳定可靠、功能强大，满足各种实时互动场景需求。如有任何疑问或技术支持，欢迎随时联系 Agora 技术团队。

常见问题解答

  1. 如何获得 Agora App ID？

    • 在 Agora 官网注册并创建一个项目后即可获得 App ID。

  2. Agora SDK 是免费的吗？

    • 是的，Agora 提供免费套餐，满足基础实时互动需求。

  3. 如何添加背景音乐到实时通话中？

    • 您可以使用 Agora SDK 的 addAudioMixing() 方法添加背景音乐。

  4. 如何使用 Agora SDK 添加滤镜？

    • 您可以使用 Agora SDK 的 setBeautyEffectOptions() 方法设置美颜和滤镜效果。

  5. 如何解决 Agora SDK 集成遇到的问题？

    • 查看 Agora 官网的文档和论坛，或联系 Agora 技术团队获取帮助。