1 功能概述
互动学堂支持连麦功能，支持学生进入课堂自动连麦、学生举手申请连麦，也支持讲师直接邀请学生连麦，并支持多人连麦，丰富课堂内容。
学生举手连麦流程：学生举手申请连麦 -> 讲师端允许学生连麦 -> 学生正式加入连麦。
讲师邀请上麦流程：讲师选择一名学生邀请上麦 -> 学生点击确定立即上麦，或等待5秒后自动上麦
2 使用演示
互动学堂连麦功能以布局方式引入，并在初始化时设置相应参数，监听回调即可。
plvhcLinkmicLy = findViewById(R.id.plvhc_linkmic_ly);
// 初始化连麦布局
plvhcLinkmicLy.init(liveRoomDataManager);
// 初始化连麦的媒体配置
boolean isOpenMic = getIntent().getBooleanExtra(EXTRA_IS_OPEN_MIC, true);
boolean isOpenCamera = getIntent().getBooleanExtra(EXTRA_IS_OPEN_CAMERA, true);
boolean isFrontCamera = getIntent().getBooleanExtra(EXTRA_IS_FRONT_CAMERA, true);
plvhcLinkmicLy.muteAudio(!isOpenMic);
plvhcLinkmicLy.muteVideo(!isOpenCamera);
plvhcLinkmicLy.switchCamera(isFrontCamera);
// 设置布局回调 - 连麦
plvhcLinkmicLy.setOnViewActionListener(new IPLVHCLinkMicLayout.OnViewActionListener() {
// 连麦布局回调方法 ...
});
详细的调用代码以及和其他模块的通信，请参考PLVHCLiveHiClassActivity类中的代码调用。
3 接口介绍
互动学堂连麦布局的接口定义为IPLVHCLinkMicLayout，接口定义了可供外部直接调用的功能方法，以及需要外部响应的事件监听器。
/**
* 初始化
*
* @param liveRoomDataManager 直播间数据管理器
*/
void init(IPLVLiveRoomDataManager liveRoomDataManager);
/**
* 设置view交互事件监听器
*
* @param listener 监听器
*/
void setOnViewActionListener(OnViewActionListener listener);
/**
* 静音音频
*
* @param mute true表示静音，false表示打开
*/
void muteAudio(boolean mute);
/**
* 禁用视频
*
* @param mute true表示禁用视频，false表示打开视频
*/
void muteVideo(boolean mute);
/**
* 切换前后置摄像头方向
*/
void switchCamera(boolean front);
/**
* 上课
*/
void startLesson(IPLVDataRequestListener<String> listener);
/**
* 下课
*/
void stopLesson(IPLVDataRequestListener<String> listener);
/**
* 发送举手事件
*
* @param raiseHandTime 举手时间
*/
void sendRaiseHandEvent(int raiseHandTime);
/**
* 设置布局的可见性
*
* @param visibility One of {@link android.view.View#VISIBLE}, {@link android.view.View#INVISIBLE}, or {@link android.view.View#GONE}.
*/
void setVisibility(int visibility);
/**
* 是否是课节上课状态
*
* @return true：是课节上课状态，false：不是课节上课状态
*/
boolean isLessonStarted();
/**
* 获取连麦Presenter
*
* @return linkMicPresenter
*/
IPLVMultiRoleLinkMicContract.IMultiRoleLinkMicPresenter getLinkMicPresenter();
/**
* 销毁，释放资源
*/
void destroy();
/**
* view交互事件监听器
*/
interface OnViewActionListener {
/**
* 布局大小变化
*/
void onLayoutSizeChanged();
/**
* 用户举手变化
*
* @param raiseHandCount 举手数量
* @param isRaiseHand 是否举手
*/
void onUserRaiseHand(int raiseHandCount, boolean isRaiseHand);
/**
* 我的画笔权限变化
*
* @param isHasPaint 是否有画笔权限
*/
void onHasPaintToMe(boolean isHasPaint);
/**
* 设置连麦readerView
*/
void onSetupLinkMicRenderView(SurfaceView surfaceView, String linkMicId);
/**
* 学生获取奖杯
*
* @param userName 用户名称
*/
void onGetCup(String userName);
/**
* 网络质量回调
*
* @param networkQuality {@link com.plv.linkmic.PLVLinkMicConstant.NetQuality}
*/
void onNetworkQuality(int networkQuality);
/**
* 上行流量网络状态
*
* @param networkStatusVO
*/
void onUpstreamNetworkStatus(PLVNetworkStatusVO networkStatusVO);
/**
* 远端连麦用户网络状态
*
* @param networkStatusVO
*/
void onRemoteNetworkStatus(PLVNetworkStatusVO networkStatusVO);
/**
* 课节准备中
*/
void onLessonPreparing(long serverTime, long lessonStartTime);
/**
* 课节开始
*/
void onLessonStarted();
/**
* 课节结束
*/
void onLessonEnd(long inClassTime, boolean isTeacherType, boolean hasNextClass);
}
4 实现介绍
IPLVHCLinkMicLayout的实现类是PLVHCLinkMicLayout，讲师和学生共用同一个布局。
4.1 初始化视图
初始化视图分为两个阶段完成：第一阶段是布局容器初始化，第二阶段是布局具体内容初始化
4.1.1 布局容器初始化
布局容器初始化在PLVHCLinkMicLayout构造时即开始执行，包括连麦视图插桩的添加、启动前台服务和保持屏幕常量等。
private void initView() {
LayoutInflater.from(getContext()).inflate(R.layout.plvhc_linkmic_layout, this, true);
classStopNoNextDialog = new PLVHCClassStopNoNextDialog(getContext());
classStopHasNextDialog = new PLVHCClassStopHasNextDialog(getContext());
// 启动前台服务，防止在后台被杀
PLVForegroundService.startForegroundService(PLVHCLiveHiClassActivity.class, "POLYV互动学堂", R.drawable.plvhc_ic_launcher);
// 防止自动息屏、锁屏
setKeepScreenOn(true);
}
4.1.2 布局具体内容初始化
布局具体内容初始化会在获取到频道限制的连麦人数后执行。
互动学堂支持 1v6 和 1v16 的连麦，这两种连麦方式的连麦视图排列方式不同，因此需要在确定频道连麦人数后才初始化具体的布局内容。
布局具体内容初始化包括连麦列表视图创建、视图尺寸调整、连麦视图回调监听设置，以及执行需要在初始化后执行的延时任务。
private void initLinkMicItemLayout(boolean isLittleLayout) {
if (isLittleLayout) {
ViewStub linkMicLyStub = findViewById(R.id.plvhc_linkmic_little_ly_stub);
linkMicItemLayout = (IPLVHCLinkMicItemLayout) linkMicLyStub.inflate();
initLayoutSize(true);
} else {
ViewStub linkMicLyStub = findViewById(R.id.plvhc_linkmic_large_ly_stub);
linkMicItemLayout = (IPLVHCLinkMicItemLayout) linkMicLyStub.inflate();
initLayoutSize(false);
}
if (linkMicItemLayout != null) {
linkMicItemLayout.setOnViewActionListener(new IPLVHCLinkMicItemLayout.OnViewActionListener() {
@Override
public void onClickItemView(final int position, final PLVLinkMicItemDataBean linkMicItemDataBean) {
// 连麦视图点击回调 ...
}
});
linkMicItemLayout.setOnRenderViewCallback(new PLVHCLinkMicItemView.OnRenderViewCallback() {
// 连麦渲染视图的回调监听 ...
});
// 延时任务执行
for (Runnable task : initiatedTasks) {
task.run();
}
initiatedTasks.clear();
}
}
4.2 初始化数据
初始化数据包括数据管理器IPLVLiveRoomDataManager的接收保存、课节详情数据的监听、PresenterIMultiRoleLinkMicPresenter的注册和初始化。
@Override
public void init(IPLVLiveRoomDataManager liveRoomDataManager) {
this.liveRoomDataManager = liveRoomDataManager;
observeLessonDataBean();
linkMicPresenter = new PLVMultiRoleLinkMicPresenter(liveRoomDataManager);
linkMicPresenter.registerView(linkMicView);
linkMicPresenter.init();
}
连麦以 mvp 模式实现，具体交互逻辑在linkMicView内实现，详情可以参考代码块 连麦 - MVP模式的view层实现。
5 子目录介绍
5.1 item
item目录存放连麦列表布局视图和连麦视图。
IPLVHCLinkMicItemLayout为连麦列表布局视图对外提供接口的定义。
PLVHCAbsLinkMicItemLayout为连麦列表布局视图的父类，具体提供了多种连麦列表布局的通用方法实现。
PLVHCLinkMicItemLittleLayout为 1v6 连麦模式下的布局视图，PLVHCLinkMicItemLargeLayout为 1v16 连麦模式下的布局视图。
PLVHCLinkMicItemView为单个连麦渲染视图。
5.2 widget
widget目录存放连麦功能特有的视图控件，包括学员被邀请上麦的倒计时弹窗。
Last updated
