How to integrate MynaParrot Bigbluebutton MP4 features in your system.
You can request to process your recording to MP4 using API. Here we did 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 require to send process request to process MP4 file. You can request up to 2 requests at a same time. After that need to wait until those 2 will finish process.
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. |
Example Requests:
https://api.mynaparrot.com/bigbluebutton/XXXX/api/processMP4?recordID=8b46e929c9e20d89f75df5d30bfdcc0b8b-1594097437792&checksum=b76be2cf5242bca922879ad2a976148f4e6c7b87
Example Response:
<response>
<returncode>SUCCESS</returncode>
<messageKey>processing</messageKey>
<message>Your request in progress. You'll receive email notification once done.</message>
</response>
2) downloadMP4
When the file will be ready that time you can send request for download. Remember, the download link will remain valid for 2 hours only.
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's length too long like more than 30 minutes or 1 hour, you may receive file in webm format but that file will play from any devices or players without any problem. Later you can convert it to MP4, if you really require but most of the time don't require. We are doing so to save time & deliver you the file soon.