实时音视频 Android

功能介绍
Classroom 支持课中呼叫功能。用户在课程进行过程中，可以随时呼叫其他用户加入当前课堂，无需提前预定或安排。通过课中呼叫功能，老师可以灵活地邀请或提醒相关人员参与课堂，提升课堂的互动性和效率。本文将详细介绍该特性的相关功能，并说明如何在 Classroom 组件中使用这一特性。
呼叫端
被呼叫端
﻿
﻿
﻿
﻿
﻿
﻿
使用说明
呼叫用户
当您在课堂中时，您可以通过如下两种方式对未上课的用户进行呼叫：
方式一：呼叫成员列表中的未上课用户
在房间的成员列表中，您会看到一个名为未进入的标题栏。点击未进入，会显示所有当前未进入课堂的成员，您可以对这些尚未进入的成员进行呼叫。
未进入的列表中包含两类用户：
当前课堂在预定时邀请且未进入的成员
已对其进行呼叫但仍未入会的成员
﻿
﻿
﻿
方式二：呼叫通讯录中的用户
通过点击底部栏中的邀请 > 添加成员，您可以唤起您自己的通讯录界面，并对其中您所选定的成员进行呼叫。
如您需要使用此功能，您需要通过如下方式，根据您的业务需求导入您自行实现的通讯录界面：
如何体验呼叫通讯录成员的功能
首先，请参见 跑通 Demo 完成 Demo 的运行。在 Demo 项目的members.json文件中，我们已经预配置了一些测试用的用户信息。您可以选择两个账号，分别在两台手机上使用我们配置的 userId 登录，然后在会议中点击底部栏的邀请 > 添加成员以唤起通讯录，在通讯录中选择另一个用户并点击确认进行呼叫。这样，另一个用户就会收到您的呼叫。
﻿
﻿
﻿
如何使用自定义通讯录
1. Classroom 关联自定义通讯录：您需要在呼叫通讯录中的用户之前，通过以下方法设置自定义通讯录：
java
kotlin
// 将 SelectParticipantActivity.class 替换为自定义通讯录的activity
ConferenceSession.sharedInstance().setContactsViewProvider(SelectParticipantActivity.class);
// 将 SelectParticipantActivity::class.java 替换为自定义通讯录的 activity
ConferenceSession.sharedInstance().setContactsViewProvider(SelectParticipantActivity::class.java)
说明：
SelectParticipantActivity为自定义通讯录代码示例，您可在 Demo 工程下(目录：app/src/main/java/com/tencent/liteav/demo/SelectParticipants) 查看。
2. 自定义通讯录向 Classroom 返回选择完毕的用户名单：在通讯录完成用户选择后，您需要将已选用户列表返回给 Classroom。您可以通过以下方法将数据返回给 Classroom。
java
kotlin
Intent intent = new Intent();
// participants 为选择完毕的用户列表，必须为 ArrayList<User> 类型。
ConferenceParticipants participants = new ConferenceParticipants();
// 添加您的成员
...
﻿
intent.putExtra(SELECTED_PARTICIPANTS, participants);
setResult(3, intent);
finish();
val intent = Intent()
// participants 为选择完毕的用户列表，必须为 ArrayList<User> 类型。
intent.putExtra(SELECTED_PARTICIPANTS, participants)
setResult(3, intent)
finish()
收到呼叫
当您在应用内收到呼叫时，会弹出如下图所示的页面。您可以拖动滑块选择立即加入，或点击暂不进入以拒绝此呼叫。
﻿
﻿
﻿
说明：
当用户已在课堂中或正在被呼叫时，该用户会自动拒绝所有呼叫。
功能定制
如果当前的 UI 不满足您的需求，您可以通过修改源代码，来实现您满意的 UI 效果。为了您更方便的定制 UI，这里对课中呼叫功能相关的文件做了介绍。
自定义被呼叫页面视图
如您需要自定义被呼叫页面的视图，请参见以下路径进行更改：
// 文件位置：Android/tuiroomkit/src/main/java/com/tencent/cloud/tuikit/roomkit/view/component/
﻿
component
    └──InvitationReceivedView.java
自定义成员列表中呼叫视图
如您需要自定义成员列表中呼叫成员的视图，请参见以下路径进行更改：
// 文件位置：Android/tuiroomkit/src/main/java/com/tencent/cloud/tuikit/roomkit/view/page/widget/UserControlPanel/
﻿
UserControlPanel
    └── CallUserView.java // 成员列表呼叫按钮 
关键代码
呼叫用户
// 文件位置：TUIRoomKit/blob/main/Android/tuiroomkit/src/main/java/com/tencent/cloud/tuikit/roomkit/model/controller/InvitationController.java
﻿
public void inviteUsers(List<UserState.UserInfo> userInfoList, TUIConferenceInvitationManager.InviteUsersCallback callback) {
    Log.d(TAG, "inviteUsers");
    if (userInfoList.isEmpty()) {
        return;
    }
    RoomToast.toastShortMessageCenter(TUILogin.getAppContext().getString(R.string.tuiroomkit_invitation_has_been_sent));
    mConferenceInvitationManager.inviteUsers(mRoomState.roomId.get(), getUserIdListFromUserList(userInfoList), INVITE_TIME_OUT_SECONDS, "", new TUIConferenceInvitationManager.InviteUsersCallback() {
        @Override
        public void onSuccess(Map<String, TUIConferenceInvitationManager.InvitationCode> invitationResultMap) {
            Log.d(TAG, "inviteUsers success");
            if (callback != null) {
                callback.onSuccess(invitationResultMap);
            }
        }
﻿
        @Override
        public void onError(TUICommonDefine.Error error, String message) {
            Log.d(TAG, "inviteUsers error=" + error + " message=" + message);
            if (callback != null) {
                callback.onError(error, message);
            }
        }
    });
}
接受呼叫
// 文件位置：TUIRoomKit/blob/main/Android/tuiroomkit/src/main/java/com/tencent/cloud/tuikit/roomkit/model/controller/InvitationController.java
    
public void accept(String roomId, TUIRoomDefine.ActionCallback callback) {
    Log.d(TAG, "accept");
    mConferenceInvitationManager.accept(roomId, new TUIRoomDefine.ActionCallback() {
        @Override
        public void onSuccess() {
            Log.d(TAG, "accept success");
            if (callback != null) {
                callback.onSuccess();
            }
        }
﻿
        @Override
        public void onError(TUICommonDefine.Error error, String message) {
            Log.d(TAG, "accept error=" + error + " message=" + message);
            if (callback != null) {
                callback.onError(error, message);
            }
        }
    });
}
拒绝呼叫
// 文件位置：TUIRoomKit/Android/tuiroomkit/src/main/java/com/tencent/cloud/tuikit/roomkit/model/controller/InvitationController.java
﻿
public void reject(String roomId, TUIConferenceInvitationManager.RejectedReason reason, TUIRoomDefine.ActionCallback callback) {
    Log.d(TAG, "reject roomId= " + roomId + " reason=" + reason);
    mConferenceInvitationManager.reject(roomId, reason, new TUIRoomDefine.ActionCallback() {
        @Override
        public void onSuccess() {
            Log.d(TAG, "reject success");
            if (callback != null) {
                callback.onSuccess();
            }
        }
﻿
        @Override
        public void onError(TUICommonDefine.Error error, String message) {
            Log.d(TAG, "reject error=" + error + " message=" + message);
            if (callback != null) {
                callback.onError(error, message);
            }
        }
    });
}
获取课堂内呼叫列表
// 文件位置：TUIRoomKit/Android/tuiroomkit/src/main/java/com/tencent/cloud/tuikit/roomkit/model/controller/InvitationController.java
﻿
private void getInvitationList() {
    Log.d(TAG, "getInvitationList");
    mConferenceInvitationManager.getInvitationList(mRoomState.roomId.get(), getAttendeeListCursor, SINGLE_FETCH_COUNT, new TUIConferenceInvitationManager.GetInvitationListCallback() {
        @Override
        public void onSuccess(TUIConferenceInvitationManager.InvitationListResult invitationListResult) {
            Log.d(TAG, "getInvitationList");
            for (TUIConferenceInvitationManager.Invitation invitation : invitationListResult.invitationList) {
                InvitationState.Invitation invitationState = new InvitationState.Invitation();
                invitationState.invitee = new UserState.UserInfo(invitation.invitee);
                invitationState.inviter = new UserState.UserInfo(invitation.inviter);
                invitationState.invitationStatus = invitation.status;
                mInvitationState.invitationList.add(invitationState);
            }
            getInvitationListCursor = invitationListResult.cursor;
            if (!"".equals(getInvitationListCursor)) {
                getInvitationList();
            }
        }
﻿
        @Override
        public void onError(TUICommonDefine.Error error, String message) {
            Log.d(TAG, "getInvitationList onError error=" + error + " message=" + message);
        }
    });
}
用户收到呼叫监听
// 文件位置：TUIRoomKit/Android/tuiroomkit/src/main/java/com/tencent/cloud/tuikit/roomkit/model/ConferenceServiceInitializer.java
﻿
private void initConferenceInvitationObserver() {
    TUIConferenceInvitationManager invitationManager = (TUIConferenceInvitationManager) TUIRoomEngine.sharedInstance().getExtension(TUICommonDefine.ExtensionType.CONFERENCE_INVITATION_MANAGER);
    invitationManager.addObserver(new TUIConferenceInvitationManager.Observer() {
        @Override
        public void onReceiveInvitation(TUIRoomDefine.RoomInfo roomInfo, TUIConferenceInvitationManager.Invitation invitation, String extensionInfo) {
            if (ConferenceController.sharedInstance().getViewState().isInvitationPending.get()) {
                ConferenceController.sharedInstance().getInvitationController().reject(roomInfo.roomId, REJECT_TO_ENTER, null);
                return;
            }
            if (ConferenceController.sharedInstance().getRoomController().isInRoom()) {
                ConferenceController.sharedInstance().getInvitationController().reject(roomInfo.roomId, IN_OTHER_CONFERENCE, null);
                return;
            }
﻿
            Bundle bundle = new Bundle();
            bundle.putString("roomId", roomInfo.roomId);
            bundle.putString("conferenceName", roomInfo.name);
            bundle.putString("ownerName", roomInfo.ownerName);
            bundle.putString("inviterName", invitation.inviter.userName);
            bundle.putString("inviterAvatarUrl", roomInfo.ownerAvatarUrl);
            bundle.putInt("memberCount", roomInfo.memberCount);
            TUICore.startActivity("InvitationReceivedActivity", bundle);
        }
    });
}
Android

本页目录：

功能介绍

使用说明

呼叫用户

方式一：呼叫成员列表中的未上课用户

方式二：呼叫通讯录中的用户

如何体验呼叫通讯录成员的功能

如何使用自定义通讯录

收到呼叫

功能定制

自定义被呼叫页面视图

自定义成员列表中呼叫视图

关键代码

呼叫用户

接受呼叫

拒绝呼叫

获取课堂内呼叫列表

用户收到呼叫监听
