Agora Call
This module enables audio and video calling functionality using the Agora platform for real-time communication.
Features
- Voice Calls: High-quality audio calls between users
- Video Calls: Face-to-face video communication
- Group Calls: Support for multi-participant calls (configurable limit)
- Call Management: Initiate, join, leave, decline, and end calls
- Call History: View history of past calls via API
- Call Status Tracking: Track call and participant status in real-time
- Configurable Quality: Choose video quality (480p, 720p, 1080p) and audio profiles
- Cloud Recording: Optional call recording support
Requirements
- Open Core Business Suite (Base System)
- OC Connect module (dependency)
- Agora account with App ID and App Certificate
Installation
Enable via Admin Panel
- Log in as administrator
- Navigate to Settings > Addons
- Find Agora Call and click Enable
- Run migrations if prompted
Enable via Command Line
php artisan module:enable AgoraCall
php artisan migrate
After enabling, configure Agora credentials in the module settings (see Configuration below).
Configuration
Access the settings page at Settings > Addon Settings > Agora Call to configure:
Agora Credentials
- Agora App ID: Your App ID from the Agora Console
- Agora App Certificate: Your App Certificate from the Agora Console
Call Settings
- Maximum Participants: Maximum number of participants in a group call (2-50, default: 10)
- Enable Recording: Enable or disable cloud recording for calls
- Auto End Call: Automatically end the call when all participants leave
- Call Timeout: Maximum duration for a call in minutes (5-1440, default: 60)
Quality Settings
- Default Video Quality: Low (480p), Standard (720p), or High (1080p)
- Audio Profile: Speech Standard, Music Standard, or Music High Quality
Usage
Making Calls
Calls are initiated from the OC Connect app:
- Start a voice or video call from a chat conversation
- Recipients receive a call notification
- Accept or decline incoming calls
During a Call
- Join or leave an active call
- Call status is tracked for all participants
- Calls auto-end when all participants leave (if enabled)
- Calls end automatically when the timeout is reached
Call History
View past call records including call status and participants via the mobile app.
Agora Account Setup
To use this module, you need to:
- Create an account at Agora.io
- Create a new project in the Agora Console
- Enable the Voice and Video Calling products
- Copy your App ID and App Certificate
- Enter the credentials in the module settings page
Technical Notes
- Agora provides global infrastructure for low-latency calls
- Token-based authentication is used for secure call access
- Call events (join, leave, decline, end) are tracked per participant
- The module generates Agora tokens on the server side for security
Changelog: View version history