You can request to process your recording to MP4 using API. Here we extended BBB API. So, you'll require to follow same procedure as you are doing for BBB API. You can find details from here: https://docs.bigbluebutton.org/dev/api.html#usage
Here 2 extra API methods for this purpose:
1) processMP4
2) downloadMP4
1) processMP4
First of all you'll need to send process requests for your MP4 file. You can send 2 requests at a time. After that, wait until they finish processing before sending new request.
Resource URL:
http://api.mynaparrot.com/bigbluebutton/XXXX/api/processMP4?[parameters]&checksum=[checksum]
Parameters:
| Param Name | Required/Optional | Type | Description |
|---|---|---|---|
| recordID | Required | String | The record ID which you want to convert into MP4. |
| mp4ReadyUrl | Optional | String |
The callback URL in which our system will send POST request when the MP4 processing will be finish |
Example Requests:
https://api.mynaparrot.com/bigbluebutton/XXXX/api/processMP4?recordID=4186dd8cc41f1e8af5e0cdc1c643632f483a97af-1586841706589&mp4ReadyUrl=https%3A%2F%2Fmywebsite.com%2FbbbMP4.php&checksum=fa24b14fe70e34173f4b425cef140614812de7b4
Example Response:
<response>
<returncode>SUCCESS</returncode>
<messageKey>processing</messageKey>
<message>Your request in progress. You'll receive email notification once done.</message>
</response> If you have given your mp4ReadyURL value then our system will send in that URL a POST request with the recordId and mp4Link. Remember, the URL given as mp4Link will only be valid for 2 hours but you can generate a new link using downloadMP4 API call.
2) downloadMP4
When the file will be ready, you can send a request to download it. The link is only valid for two hours and can be generated again by using this same API call.
Resource URL:
http://api.mynaparrot.com/bigbluebutton/XXXX/api/downloadMP4?[parameters]&checksum=[checksum]
Parameters:
| Param Name | Required/Optional | Type | Description |
|---|---|---|---|
| recordID | Required | String | The record ID which you want to download after MP4 process |
Example Requests:
https://api.mynaparrot.com/bigbluebutton/XXXX/api/downloadMP4?recordID=8b46e929c9e20d89f75df5d30bfdcc0b8b-1594097437792&checksum=b76be2cf5242bca922879ad2a976148f4e6c7b87
Example Response:
<response>
<returncode>SUCCESS</returncode>
<messageKey>gotURL</messageKey>
<mp4url>http%3A%2F%2Fr2.mynaparrot.es%2F6746627497a68bf020d3a13ac808058176f2ed56-1593532353702.mp4%3Fkey%3D8ESMSW66NAYbpd9S4RFmwg%26expires%3D1595219472</mp4url>
</response>
Note: If the recording is longer than 30 minutes, then you may receive it in a webm format. This will play on any devices or players. You can later convert this to mp4 if you really need but most of the time don't need to. We are doing so to save time & deliver you the file faster.
MP4/webm files will be deleted automatically after 7 days, so you'll need to download the file prior to that time. It will not be possible for you to send your request a second time if the MP4/webm file has been deleted after 7 days.