edit-icon download-icon

Overview

Last Updated: Apr 18, 2018
  • Upload

    Provides upload SDK, supports the web version (JavaScript) and mobile versions (Android and iOS).

    Uploads a video file using the console or a third-party tool.

  • Functions

    Provides user-friendly APIs. You only need to specify the location to store local and OSS files.

    Supports resumable upload, multi-file queue, ultra-large files, recovery from network anomalies, and security mechanisms.

    A media workflow is automatically triggered.

  • Media workflow triggering

    After a multimedia file is uploaded to the input bucket and path specified by the media workflow, the media workflow is automatically executed based on the specified process.

    The following conditions must be met when an OSS file is uploaded to automatically trigger a media workflow:

    • Match the media workflow

      For details on workflow triggering and matching rules, see Add media. The workflow is in the Activated state.

    • Match the file name extension

      Only a multimedia file can trigger a media workflow, which is determined by the media repository using the file name extension. The file does not contain an extension (the file name does not contain the extension separator “.”) or the extension meets the following rules:

      • Videos

        3gp, asf, avi, dat, dv, flv, f4v, gif, m2t, m3u8, m4v, mj2, mjpeg, mkv, mov, mp4, mpe, mpg, mpeg, mts, ogg, qt, rm, rmvb, swf, ts, vob, wmv and webm.

      • Audios

        aac, ac3, acm, amr, ape, caf, flac, m4a, mp3, ra, wav, wma and aiff.

    • Specify media attributes

      You can specify media attributes, including the title, tag, description, category, cover URL, and custom data, to trigger a media workflow. For details about the attribute description, see “Request parameters” in Add Media.

  • Security

    In normal scenarios, a video file is directly uploaded using a client. In this case, the AccessKey must be securely stored on the client. Once being disclosed, the AccessKey is exposed to high risk and hard to be replaced. We recommend that the client access an application to obtain the AccessKey and use the Token provided by RAM.

  • Recommended process

    2

    1. Request the token

      Before each time a file is uploaded, you can use a video application (in App or web mode) to access the application service of the business end. The application service obtains a token from RAM and sends it back to the video application. This ensures the security, implements identity verification and permission control, and records your upload history.

      Before using a token, Set a subaccount and permissions.

      For details, see Java sample code. (For details about how to use the token in other languages, see STS documentation).

    2. Upload a file

      After integrating the upload SDK to the video application, you can upload files using the obtained token. For details, see Usage instruction.

      • Web

        As JavaScript files are stored in an application or CDN domain and video files are stored in an OSS domain, a cross-region request is involved when a JavaScript file is uploaded. In this case, Set CORS.

        JavaScript

      • Mobile

        Android

        iOS

Next step: Wait for a completion notification

Thank you! We've received your feedback.