package sagittarius.media.v1

Get desktop application:
View/edit binary Protocol Buffers messages

Service that implements Sagittarius Media API

• rpc GetInfo (GetInfoRequest, Info)

  media.proto:32

  message GetInfoRequest

  media.proto:93

  retrieve media info like sound track resolutions, length/duringation etc.

  • string media_hash = 1

    quick hash of the media. For example: "media/1111-2222-3333-4444/info".

• rpc GetThumbnail (ThumbnailRequest, ThumbnailResponse)

  media.proto:54

  Get thumbnail by timestamps

  message ThumbnailRequest

  media.proto:138

  • string media_hash = 1

  • oneof time

    which thumbnail the client wants

    • TimeRange range = 2

    • double timestamp = 3

  • string token = 4

    access token for read and write thumbnail by timestamp

  message ThumbnailResponse

  media.proto:158

  • optional google.rpc.Status error = 1

  • repeated Thumbnail thumbnails = 2

    thumbnails. with timestamp, extension, and payload

• rpc GetThumbnailTimeRanges (ThumbnailTimeRangesRequest, ThumbnailTimeRangesResponse)

  media.proto:47

  Query obtainable thumbnails time range and unavailable ones by media identity

  message ThumbnailTimeRangesRequest

  media.proto:107

  try to retrieve Thumbnails

  • string media_hash = 1

    use quick media hash to get thumbnails

  • double media_length = 2

    time length of the media resource, in seconds

  message ThumbnailTimeRangesResponse

  media.proto:124

  • optional google.rpc.Status error = 1

  • string media_hash = 2

    time range is used to tell the client the screenshot range

  • repeated TimeRange availables = 3

    thumbnails that the server have, in time ranges

  • repeated TimeRange missings = 4

    thumbnails that the server is missing and wanted, in time ranges

  • string token = 5

    access token for read and/or write thumbnail by timestamp session_token will not have write premission if there is not missing

• rpc UpdateInfo (UpdateInfoRequest, Info)

  media.proto:39

  message UpdateInfoRequest

  media.proto:99

  try to update media info

  • string media_hash = 1

    quick hash of the media. For example: "media/1111-2222-3333-4444/info".

  • optional Info info = 2

    the media info to be updated

• rpc UpdateThumbnail (UpdateThumbnailRequest, google.rpc.Status)

  media.proto:62

  Update thumbnail by timestamps

  message UpdateThumbnailRequest

  media.proto:165

  • string media_hash = 1

  • repeated Thumbnail thumbnails = 2

    the thumbnails to be updated

  • string token = 3

    access token for read and write thumbnail by timestamp

Used as response type in: Media.GetInfo, Media.UpdateInfo

Used as field type in: UpdateInfoRequest

• string media_hash = 1

  Resource id of the media. It must have the format of "media/*/info". For example: "media/1111-2222-3333-4444/info".

• repeated Info.TrackInfo tracks = 2

Used in: Info

• TrackInfo.Type types = 1

Used in: TrackInfo

• VIDEO = 0

• AUDIO = 1

• TEXT = 2

• OTHER = 3

Used in: ThumbnailResponse, UpdateThumbnailRequest

• double timestamp = 1

  timestamp of this thumbnail in relative to the begginning of the media_hash

• string ext = 2

  image's file extension

• bytes payload = 3

  image's binary content

time range is used to tell the client the screenshot range

Used in: ThumbnailRequest, ThumbnailTimeRangesResponse

• double begin = 1

  the beginning of the time range, in seconds

• double end = 2

  the end of the time range, in seconds

• double interval = 3

  time interval between each thumbnails, in seconds