Virtual Classroom

Host live online classes with real-time video conferencing powered by LiveKit. Conduct interactive lessons, share your screen, and track student attendance automatically.

Key Features

Creating a Live Class

Follow these steps to create and host a live class session:

Step 1: Access the Virtual Classroom Dashboard

1. Navigate to the Teacher Dashboard
2. Click on "Virtual Classroom" in the sidebar navigation
3. You'll see the class management interface with a creation form and your existing classes

Step 2: Fill in Class Details

Complete the "Create New Class" form with the following information:

Step 3: Start the Class

1. Click "Create Class" to generate the live classroom
2. The class will appear in your "Your Classes" list with an Active status
3. Click "Enter Classroom" to join the video room

Sharing Class Links with Students

Students can join your live class through multiple methods:

Method 1: Copy Direct Link

1. Find your class in the dashboard
2. Click the "Copy Link" button
3. Share the copied URL via email, WhatsApp, or your preferred messaging platform
4. Students click the link to join directly

Method 2: Live Classes Section on Homepage

Active classes are automatically displayed in the "Live Now" section on the homepage, allowing students to discover and join ongoing sessions.

In-Class Controls

Once inside the virtual classroom, you have access to several controls:

Real-Time Attendance Tracking

Celebra automatically tracks student attendance during live classes. The system records:

• Join Time - When the student entered the classroom
• Leave Time - When the student exited the classroom
• Duration - Total time spent in the class (in minutes)
• Multiple Sessions - If a student leaves and rejoins, each session is logged separately

Viewing Attendance Reports

1. Go to your Virtual Classroom dashboard
2. Find the class you want to review
3. Click the "View Report" button
4. An attendance table expands showing all participants

Dashboard Summary & Statistics

The Virtual Classroom dashboard provides at-a-glance statistics about your teaching activities:

Class History

Access your complete class history through the "Class History" tab on the dashboard. This allows you to:

• Review all previously held classes
• View attendance reports for any past session
• See the date and time each class was held
• Track total participants per session
• Delete old class records when no longer needed

Active vs History View

The dashboard uses tabs to separate your classes:

• Active Classes - Classes currently in session that you can enter or share
• Class History - Completed classes with preserved attendance records

Auto-Cleanup Feature

The auto-cleanup feature helps manage resources efficiently:

• 5-Minute Timeout - If no participant joins or interacts with the class for 5 minutes, it will be automatically ended
• Notification - You'll receive a toast notification when a class is auto-ended
• Data Preserved - Attendance records are kept even for auto-ended classes
• Moved to History - Auto-ended classes appear in your Class History tab

Why Auto-Cleanup?

1. Resource Conservation - Prevents abandoned rooms from consuming server resources
2. Clean Dashboard - Keeps your active classes list relevant and current
3. Cost Efficiency - Reduces unnecessary video streaming costs

Student Pre-Join Form

Before students can enter a live classroom, they must complete an identity form. This ensures accurate attendance tracking and helps you identify participants.

Information Collected

• Full Name (required) - Student's complete name
• Email Address - For contact purposes
• Phone Number - Optional contact information
• School Name - The school the student attends
• Form/Class - The student's current class level
• Admission Number - For identification within the school

This information appears in your attendance report, making it easy to identify exactly who attended each session.

Managing Classes

Ending a Class

When your lesson is complete:

1. Click the "Leave" or disconnect button in the video room
2. Students will also be disconnected and redirected to the homepage
3. The class status will change from "Active" to "Ended"
4. Attendance records are preserved for later review

Deleting a Class

To remove a class from your list:

1. Find the class in your dashboard
2. Click the trash icon button
3. Confirm the deletion

Technical Requirements

Browser Support

The Virtual Classroom works best on modern browsers with WebRTC support:

• Google Chrome (recommended)
• Mozilla Firefox
• Microsoft Edge
• Safari (iOS 14.3+ and macOS 11+)

Network Requirements

Permissions Required

Students and teachers must grant browser permissions for:

• Camera access
• Microphone access
• Screen sharing (for teachers presenting)

Troubleshooting

Video/Audio Not Working

1. Check browser permissions for camera and microphone
2. Ensure no other application is using the camera/microphone
3. Try refreshing the page
4. Check if your browser is up to date

Connection Issues

1. Verify your internet connection is stable
2. Try switching from WiFi to mobile data (or vice versa)
3. Close bandwidth-heavy applications
4. Disable VPN if connected

Students Can't Join

1. Verify the class link is correct and complete
2. Ensure the class is marked as "Active"
3. Ask students to try a different browser
4. Check if students have granted browser permissions

Best Practices

Related Features