How to use server-relayed WebRTC group calls to record 1:1 voice & video calls in the cloud (iOS)
Introduction
Sendbird Calls is a highly abstracted API that allows developers to build feature-rich in-app voice and video calls in web and mobile apps without being bogged down by low-level WebRTC and media infrastructure details.
In this tutorial, you’ll learn how to use Sendbird’s video call API to record 1-1 calls in the cloud by using a virtual room for group calls.
Reconciling P2P WebRTC calls with cloud recording by using a video call API
The Sendbird video call SDKs support direct and group calls. Direct calls, also referred to as 1-1 calls or one-on-one calls, can either be peer-to-peer (p2p) or server-relayed. The peer-to-peer connection is always preferred for quality, security, and cost reasons. That’s why our platform will always default to p2p when possible to reduce cost and optimize privacy.
Because p2p voice and video calls establish a direct connection between two devices, cloud recording is not possible. Calls can be recorded only on either device. Cloud recording of a 1–1 call, however, requires a media-server connection. There is a simple way to circumvent this limitation: you can use the Sendbird video call API to host a server-relayed group call with only 2 participants and record the media content in the cloud.
Step 1: Create a room for your video call
First, let’s create a room from which calls will take place. Two users will join this room and talk to each other in a 1-1 call. With the Sendbird video call API, set the room type and create the room.
Step 2: Enter a room
The caller (the person who initiates the call) will now need to enter the room. When a user enters the room, they will be automatically connected to the Sendbird server.
Step 3: WebRTC signaling: Invite the callee
In 1-1 or direct calls, the caller (the person who initiates the call) sends a ringing signal to the callee (the person who is called). The callee then has to accept or reject the incoming call.
In a group call, you can mimic this by sending an invitation to the callee. Sending an invitation to join the room will send a push notification to the callee. Similar to a 1-1 call, the callee can either accept or decline.
Refer to the following code to invite the callee using their user ID as the `inviteeId`.
At this point, you may want to show a dialing screen to notify the user that they are dialing the callee.
Step 4: Receive an invitation
When the callee receives an invitation, they will receive a push notification message which contains the information about the room.
In order to receive push notifications, you must first upload a push notification certificate to the Sendbird dashboard and register the user’s device push token. Please refer to the docs to see how to get started with notifications for Sendbird Calls. You might also find this guide about push notifications FAQ useful. For more information, you can also refer to the many tutorials for Android, iOS, and JavaScript on our developer portal, including a push notification tester tool tutorial.
In this tutorial, we’ll use Apple’s remote notifications. You must pass on the received push notification to the Sendbird Calls SDK as shown below.
When the push notification is delivered to the SDK, SendbirdCallsDelegate’s `didReceiveInvitation` will be called. Inside this method, you can either answer or decline the invitation.
Step 5: Accept or decline the invitation
Accepting or declining the invitation will send a response to the caller to let them know if the callee has chosen to accept or decline the invitation.
You can also receive event handlers about the callee’s response to the invitation as shown below:
Step 6: Connect the users
After accepting the invitation, the callee has to enter the room to be finally connected with the caller in the same room.
The callee enters the room as shown below:
After entering the room, the two users will be automatically connected and each other’s media streams will be viewable. When a user enters and gets connected to the room, the following event handlers will be called.
You can add UI updates to these event handlers to show the user when the callee accepts the call, and begins and finishes connecting to the room.
Conclusion
And that’s a wrap! You now know how to record 1-1 video calls in the cloud using Sendbird’s video call API. You’ve learned how to:
Use the video call API to create and enter a room
Signal to your correspondent an incoming call with push notifications
Allow the callee to respond
Host a call between the two participants in a room
If you need more help with the material in the tutorial, please see our docs. If you have questions, please reach out to us via the Sendbird community or through your support plan. Don’t hesitate to contact us - our experts are here to help.
Happy group calls building and cloud recording! ☁️