This topic describes the features and scenarios of media libraries.

Features

  • Media workflow management: allows you to create, delete, modify, activate, and deactivate a media workflow and query one or more media workflows.
  • Management of execution instances of a media workflow: allows you to traverse and query execution instances of a media workflow.
  • Media management: allows you to add, remove, and modify a media asset, query one or more media assets, maintain parameters (the title, tag, thumbnail, and description) of a media asset, and set the publishing status of a media asset.
  • Media category management: allows you to create, delete, and modify a media category and query one or more media categories.

Scenarios

  • Search for media assets

    Search for media assets that meet search criteria in a media library.

    The following search methods are supported:
    • Use keywords to search for media assets by performing a logical disjunction: A media asset is displayed if and only if one or more of the title, tag, description, and category are matched.
    • Use a combination of parameters to search for media assets by performing a logical conjunction: A media asset is displayed if and only if all specified parameters (at least two of the title, tag, description, and category) are matched.

    In the search criteria, you can specify the creation time range to limit the search range. You can also specify whether to sort the search results by creation time in ascending or descending order.

    In addition, if many media assets are to be returned, you can have them displayed on pages.

  • Maintain parameters of a media asset

    Each media asset has the following basic parameters: title, tag, description, and category. You can configure the basic parameters by calling API operations. For more information about the sample code, see Query and update the basic information of a media asset.

  • Query the details of a media asset
    A media asset contains an input file and several output files such as videos and snapshots. You can query the detailed input and output information of a media asset. For more information about the sample code, see Query the details of a media asset.
    • Input information includes the basic parameters and details of a video. The basic parameters of a video include the width, height, duration, size, bitrate, and frame rate. The video details include the container format, the video, audio, and subtitle streams, and the detailed parameters of the container format and streams.
    • Output video information includes the basic parameters and Object Storage Service (OSS) URLs of videos. The basic parameters of a video include the width, height, duration, size, bitrate, and frame rate. Output snapshot information includes the types and OSS URLs of snapshots. The supported types of snapshots are single frame snapshots and batch snapshots.
  • Manage tags of a media asset

    ApsaraVideo Media Processing (MPS) does not support global tag management in media libraries. Tags of each media asset are independently set for the media asset. However, you can call the API operation for searching for media assets to query all media assets with the same tags. For more information about the sample code, see Manage tags of a media asset.

Manage media libraries

You can use MPS SDKs to manage media libraries. MPS SDKs for Java, Python, and PHP are supported. For more information, see Java SDK, Python SDK, and PHP SDK. You can also directly call API operations over HTTP or HTTPS to manage media libraries. For more information, see API Reference.