Conduct Live Online Classes

Conduct Live Online Classes

Host real-time video classes with password protection, screen sharing, emoji reactions, and participant management.

Time: 2–5 minutes to set up Module: OpenEduCat Live Permissions: Faculty or Meeting Organizer

---

Prerequisites

• Modern web browser with WebRTC support
• Camera and microphone access
• Calendar module installed
• Discuss module configured
• Access to Calendar application

---

Overview

The Live Classes system enables:

• WebRTC-based video conferencing
• Password-protected meeting rooms
• Screen sharing with host controls
• Emoji reactions and hand raising
• Meeting lock to prevent late entry
• Integration with calendar scheduling
• Course, batch, and subject linking

---

Technology

The module uses WebRTC (Web Real-Time Communication):

• Peer-to-peer video connections
• Browser-based (no plugins required)
• Supports: Chrome, Firefox, Edge, Safari

Browser Requirements:

• RTCPeerConnection support
• MediaStream API support
• Camera and microphone permissions

---

Steps

1. Schedule a Live Class

1. Navigate to Calendar application
2. Click on a time slot or click New
3. Complete the event form:

Field	Action
Subject	Enter class title
Start	Set start date and time
End	Set end date and time
Attendees	Add student/faculty contacts

4. Enable live meeting:

   • Check Create Meeting checkbox
   • System creates a discuss channel
   • Password auto-generated

5. In Meeting tab:

Field	Action
Course	Select course (optional)
Batch	Select batch (filtered by course)
Subject	Select subject (optional)

6. Click Save

2. Share Meeting Details

After saving, the event includes:

• Video Call URL: Auto-generated meeting link
• Password: Participant access password
• Moderator Password: Host control password

Attendees receive:

• Calendar invitation with meeting link
• Password for joining

3. Start the Live Class

1. Open the calendar event

2. Click the Join Meeting button or use the video call URL

3. On the welcome page:

   • Preview your camera
   • Test microphone
   • Enter password (if required)

4. Click Join to enter the meeting

4. Host Controls

As the meeting host, you can:

Control	Action
Lock Meeting	Prevent new participants from joining
Password Lock	Enable/disable password requirement
End Meeting	Close session for all participants
Mute/Unmute	Control your audio
Camera On/Off	Control your video
Screen Share	Share your screen
Disable Screen Share	Prevent participants from sharing

5. Participant Features

Participants can:

• Raise hand (notification to host)
• Send emoji reactions
• Share screen (if enabled)
• Mute/unmute audio
• Turn camera on/off

---

Meeting Security

Password Protection

1. Passwords are auto-generated (10 characters)
2. Uses alphanumeric characters (excludes confusing: l, O)
3. Two password types:
   • Participant Password: For attendees
   • Moderator Password: For host controls

Lock Meeting

1. Click Lock Meeting button
2. Icon changes to locked state
3. New participants see “Meeting Locked” message
4. Unlock by clicking again

Welcome Page Validation

When joining, system checks:

1. Is meeting locked? → Shows “lock-meeting” error
2. Is password required? → Shows password input
3. Password correct? → Allows entry
4. Wrong password → Shows “incorrect-password” error

---

Screen Sharing

Enable/Disable Screen Sharing

Host can control participant screen sharing:

1. Click Settings menu
2. Find Screen Share Disable checkbox
3. Check to prevent participants from sharing
4. Uncheck to allow sharing

Share Your Screen

1. Click Screen Share button

2. Browser prompts for screen selection:

   • Entire screen
   • Application window
   • Browser tab

3. Select and click Share

4. Other participants see your screen

5. Click Stop Sharing to end

---

Emoji Reactions

Send Emoji

1. Click Emoji button in call actions
2. Select emoji from picker
3. Emoji displays next to your name
4. Other participants see your reaction

Hand Raising

1. Click Raise Hand button
2. Hand icon appears in participant list
3. Host sees notification
4. Click again to lower hand

---

Field Reference

Calendar Event Extension

Field	Technical Name	Type	Description
Create Meeting	is_meeting	Boolean	Enable live meeting
Meeting Started	is_start_meeting	Boolean	Meeting active flag
Password	is_password	Char	Participant password
Channel	channel_id	Many2one	Linked discuss channel
Course	course_id	Many2one	Associated course
Batch	batch_id	Many2one	Associated batch
Subject	subject_id	Many2one	Associated subject

Discuss Channel Extension

Field	Technical Name	Type	Description
Lock Meet	is_lockmeet	Boolean	Meeting locked
Lock Password	is_lockpassword	Boolean	Password required
End Meet	is_EndMeet	Boolean	Meeting ended
Password	is_password	Char	Access password
Host ID	host_id	Integer	Host user ID
Sheet ID	sheet_id	Integer	Attendance sheet link
Calendar	calendar_id	Many2one	Linked calendar event

RTC Session Extension

Field	Technical Name	Type	Description
Screen Share Disabled	is_screen_show	Boolean	Host disabled sharing
Hand Raised	is_hand_raised	Boolean	Participant raised hand
Emoji	is_Emoji	Char	Current emoji reaction
Badge Emoji	is_badgeemoji	Char	Badge emoji status
Attentiveness	is_Attentiveness	Boolean	Tab focus tracking

---

API Endpoints

The module provides JSON-RPC endpoints:

Endpoint	Purpose
/mail/rtc/session/welcomepage	Validate password
/mail/rtc/session/lock-meeting	Lock/unlock meeting
/mail/rtc/session/check-ishost	Verify host status
/mail/rtc/session/lock-password	Toggle password lock
/mail/rtc/session/check-lock	Check password status
/mail/rtc/session/create-password	Generate password
/mail/rtc/session/get-password	Retrieve password
/mail/rtc/session/update-and-emoji	Update emoji status

---

Meeting States

Participant View States

State	Description
Connecting	Establishing WebRTC connection
Connected	In meeting, can interact
Muted	Audio disabled
Camera Off	Video disabled
Screen Sharing	Sharing screen
Hand Raised	Requested to speak

Host View Indicators

• Participant count
• Audio/video status for each
• Hand raise notifications
• Emoji reactions
• Attentiveness tracking (tab focus)

---

Troubleshooting

Issue	Cause	Solution
Camera not working	Browser permissions	Allow camera access
No audio	Microphone blocked	Check browser permissions
Cannot join	Meeting locked	Wait for host to unlock
Wrong password	Typo or changed	Verify password with host
Black screen	WebRTC unsupported	Use supported browser
Poor quality	Network issues	Check internet connection
Screen share fails	Browser restrictions	Try different screen option
Others can’t hear	Muted	Unmute microphone

Browser Compatibility Check

The welcome page automatically checks:

• RTCPeerConnection availability
• MediaStream support

If unsupported, shows error message with browser upgrade recommendation.

---

Best Practices

1. Test equipment: Check camera and mic before class
2. Share password: Ensure students have access credentials
3. Lock timing: Lock meeting after expected participants join
4. Mute policy: Ask participants to mute when not speaking
5. Screen prep: Close sensitive windows before sharing
6. Backup plan: Have alternate communication method ready
7. Record important sessions: Use browser recording if needed

---

Integration Features

Calendar Integration

• Events sync with meeting creation
• Attendees auto-added to channel
• Meeting URL in event description
• Automatic cleanup on event deletion

Course/Batch Linking

• Associate meetings with specific courses
• Link to batches for student filtering
• Subject assignment for topic tracking

Attendance Integration

• sheet_id field links to attendance module
• Track meeting participation
• Generate attendance reports

---

Security Notes

Role	Capabilities
Meeting Host	Full control (lock, password, end)
Participants	Join, react, screen share (if enabled)
Guest Users	Limited access via public routes

Password Security

• 10-character random passwords
• Alphanumeric (avoids confusing characters)
• Separate moderator and participant passwords
• Can be regenerated by host

---

Related Tasks

• Schedule Calendar Events
• Configure Email Notifications
• Manage Course Settings