Skip to main content

You are viewing Agora Docs forBetaproducts and features. Switch to Docs

  • Core Products
  • Add-Ons
  • Extensions Marketplace

    Play recorded files online

    Introduction​

    The Agora server automatically uploads the recorded files in TS format to the cloud storage that you set up, and generates an M3U8 file as a playlist pointing to all the recorded TS files. You can get the URL of the M3U8 file and play it online.

    If Agora Cloud Recording generates WebM files instead of TS files, you cannot play the M3U8 file online.

    Implementation​

    Before you start, ensure that all the recorded files are uploaded (the uploadingStatus in the response of stop is "uploaded").

    We use Amazon S3 as an example to show you how to play the recorded files online.

    1. Log in the Amazon S3 console.

    2. Go to the Overview page of the bucket that you use for cloud recording.

    3. Set the metadata of the files as follows:

      1. Select the M3U8 file.
      2. Click Actions.
      3. Select Change metadata.
      4. Set the Value of the Content-Type Key as application/x-mpegURL (you need to type in this value). 5.Select all the TS files and set Content-Type as video/MP2T.

    4. Configure the bucket policy so that it can be accessed publicly:

      1. On the Permissions tab, click Bucket Policy.
      2. Paste the following code and change <YourBucketName> to the name of your bucket.

      _16
      {
      _16
      "Version": "2012-10-17",
      _16
      "Id": "Policy1553255976836",
      _16
      "Statement": [
      _16
      {
      _16
      "Sid": "Stmt1553255974279",
      _16
      "Effect": "Allow",
      _16
      "Principal": "*",
      _16
      "Action": "s3:*",
      _16
      "Resource": [
      _16
      "arn:aws:s3:::<YourBucketName>",
      _16
      "arn:aws:s3:::<YourBucketName>/*"
      _16
      ]
      _16
      }
      _16
      ]
      _16
      }

      1. Click Save.

    5. Select the M3U8 file to view the URL.

    6. Navigate to the URL on a web browser to start playing the recorded files.

    See How to Serve HLS Video from an S3 Bucket for more information.

    Considerations​

    • The M3U8 file can be played directly on Safari. For other web browsers, you might need to install an HLS playback extension.
    • You can also play the M3U8 file on players supporting HLS, such as the VLC media player.
    • If the uploadingStatus in the response of stop is "backuped", it indicates that some of the recorded files are uploaded to Agora's backup cloud storage. You should wait until these files are uploaded automatically to your cloud storage before playing the M3U8 file.
    • If you do not need to play the recorded files online, we suggest that you make your bucket private to improve security.
    vundefined