Live Streaming By API Video (Deprecated)

Deprecated: This extension is no longer maintained and will not receive further updates.

The Live streaming by api.video extension enables you to set up a live stream to broadcast to a large number of users.

Before you begin

Sign up with api.video
Get your API Key. Make sure you set up a payment method with them in order to get the Production API key. The Sandbox API Key will not work.
Broadcaster needs to download and install OBS, a free and open-source software.

Extension settings

Login to CometChat and select your app.
Navigate to Chat & Messaging → Features and enable Live Streaming (Video Broadcasting).
Open the Settings for this extension.
Enter the api.video Production API Key.
You can also select whether you want to record the live stream.

How does it work?

This extension delivers 2 different configurations:

The broadcaster gets the server address and streamKey.
The viewers get the embed link along with a few more details.

Broadcaster

1. Get broadcast details

The CometChat SDKs provide a callExtension method that can be called to trigger this extension. The broadcaster has to provide the following:

Receiver type - user or group
The receiver of the broadcast link (can be a uid for a user or guid in case of a group)

JavaScript
Java
Swift

CometChat.callExtension('broadcast', 'POST', 'v1/broadcast', {
  receiverType: 'user/group',
  receiver: 'uid/guid'
}).then(response => {
 // Success response
}).catch(error => {
 // Some error occured
});

import org.json.simple.JSONObject;

JSONObject body=new JSONObject();
body.put("receiverType", "user/group");
body.put("receiver", "uid/guid");

CometChat.callExtension("broadcast", "POST", "/v1/broadcast", body,
    new CometChat.CallbackListener<JSONObject>() {
    @Override
    public void onSuccess(JSONObject responseObject) {
        // Broadcaster details
    }

    @Override
    public void onError(CometChatException e) {
        // Some error occured.
    }
});

CometChat.callExtension(slug: "broadcast", type: .post, endPoint: "v1/broadcast", body: ["receiverType":"user/group", "receiver":"uid/guid"], onSuccess: { (response) in
        // Success response
      }) { (error) in
        // Some error occured
      }

If the call is successful, the method will return the following JSON response:

JSON

{
   "broadcaster": {
      "server": "rtmp://broadcast.api.video_s",
      "streamKey": "04cb0167-5za4-4ba6-831x-efa28e1917o3"
   }
}

2. Start Streaming

In order to start streaming/broadcasting, launch OBS studio and go to: Settings > Stream > Select Custom from drop-down and enter the server and streamKey. Once the details have been entered, click OK and close the Settings Panel. Next, you can click on the “Start Streaming” button.

Viewers

The viewers can either be a Group or a User. The recipient(s) will receive a text message with embed link and metadata as follows:

Text message
JSON

Hello! I’m currently broadcasting. Use this link to join the broadcast: https://embed.api.video/live/li3WPpN3Ixj7dTDwdtL0dKt1

"@injected": {
  "extensions": {
    "broadcast": {
      "hls": "https://live.api.video/li6xl2dCcboxPGTFq1D4Fhmb.m3u8",
      "iframe": "<iframe src=\"https://embed.api.video/live/li6xl2dCcboxPGTFq1D4Fhmb\" width=\"100%\" height=\"100%\" frameborder=\"0\" scrolling=\"no\" allowfullscreen=\"\"></iframe>",
      "player": "https://embed.api.video/live/li6xl2dCcboxPdGTFq1D4Fhmb",
      "thumbnail": "https://cdn.api.video/live/li6xl2dCcboxPGTFq1D4Fhmb/thumbnail.jpg"
    }
  }
}

Implementation

At the viewers’ end, from the message object, you can fetch the metadata by calling the getMetadata() method. Using this metadata, you can fetch the broadcast details.

JavaScript
Java
Kotlin
Swift

var metadata = message.getMetadata();
if (metadata != null) {
  var injectedObject = metadata["@injected"];
  if (injectedObject != null && injectedObject.hasOwnProperty("extensions")) {
    var extensionsObject = injectedObject["extensions"];
    if (
      extensionsObject != null &&
      extensionsObject.hasOwnProperty("broadcast")
    ) {
      var broadcastObject = extensionsObject["broadcast"];
    }
  }
}

JSONObject metadata = message.getMetadata();
if (metadata != null) {
  JSONObject injectedObject = metadata.getJSONObject("@injected");
  if (injectedObject != null && injectedObject.has("extensions")) {
    JSONObject extensionsObject = injectedObject.getJSONObject("extensions");
    if (extensionsObject != null && extensionsObject.has("broadcast")) {
          JSONObject broadcastObject = extensionsObject.getJSONObject("broadcast");
        }
    }
}

if (metadata != null) {
  if (metadata.has("@injected")) {
   val injectedJSONObject = metadata.getJSONObject("@injected")
   if (injectedJSONObject != null && injectedJSONObject.has("extensions")) {
   val extensionsObject = injectedJSONObject.getJSONObject("extensions")

   if (extensionsObject != null && extensionsObject.has("broadcast")) {
     val broadcastObject = extensionsObject.getJSONObject("broadcast")
   }
  }
 }
}

let textMessage = message as? TextMessage
var metadata : [String : Any]? = textMessage.metaData
if metadata != nil {

    var injectedObject : [String : Any]? = (metadata?["@injected"] as? [String : Any])!
            
    if injectedObject != nil && (injectedObject!["extensions"] != nil){

      var extensionsObject : [String : Any]? = injectedObject?["extensions"] as? [String : Any]

      if extensionsObject != nil && extensionsObject?["broadcast"] != nil {
        var broadcastObject = extensionsObject?["broadcast"] as! [String :  Any]
      }
   }
}

Features

User-Roles

Guides

Media

Live Streaming By API Video (Deprecated)

Before you begin

Extension settings

How does it work?

Broadcaster

1. Get broadcast details

2. Start Streaming

Viewers

Implementation

​Before you begin

​Extension settings

​How does it work?

​Broadcaster

​1. Get broadcast details

​2. Start Streaming

​Viewers

​Implementation

Before you begin

Extension settings

How does it work?

Broadcaster

1. Get broadcast details

2. Start Streaming

Viewers

Implementation