package media

Get desktop application:
View/edit binary Protocol Buffers messages

Used in: AudioMetadata

• AUDIO_CODEC_UNSET = 0

• AUDIO_CODEC_AAC = 1

• AUDIO_CODEC_HEAAC = 2

• AUDIO_CODEC_OPUS = 3

Used in: MediaMetadata

• AudioCodecFormat codecFormat = 1

  enum

Used in: MediaMetadata

• bool flashOn = 1

• bool frontFacing = 2

Used in: contentEnvelope.ContentEnvelope, MediaReferences

• repeated MediaReference reference = 1

Used in: MediaMetadata

• DISPLAY_ORIENTATION_UNSET = 0

• DISPLAY_ORIENTATION_UP = 1

  * UP - The original pixel data matches the media's intended display orientation.

• DISPLAY_ORIENTATION_DOWN = 2

  * DOWN - Rotate the original pixel data by 180 degree to match the media's intended display orientation.

• DISPLAY_ORIENTATION_LEFT = 3

  * LEFT - Rotate the original pixel data by 90 degree counterclockwise to match the media's intended display orientation.

• DISPLAY_ORIENTATION_RIGHT = 4

  * RIGHT - Rotate the original pixel data by 90 degree clockwise to match the media's intended display orientation.

• DISPLAY_ORIENTATION_UP_MIRRORED = 5

  * UP_MIRRORED - Horizontally flip the original pixel data to match the media's intended display orientation.

• DISPLAY_ORIENTATION_DOWN_MIRRORED = 6

  * DOWN_MIRRORED - Vertically flip the original pixel data to match the media's intended display orientation.

• DISPLAY_ORIENTATION_LEFT_MIRRORED = 7

  * LEFT_MIRRORED - Rotate the original pixel data by 90 degree clockwise and flip horizontally to match the media's intended display orientation.

• DISPLAY_ORIENTATION_RIGHT_MIRRORED = 8

  * RIGHT_MIRRORED - Rotate the original pixel data by 90 degree counterclockwise and flip horizontally to match the media's intended display orientation.

Used in: ImageMetadata

• IMAGE_CODEC_UNSET = 0

• IMAGE_CODEC_JPEG = 1

• IMAGE_CODEC_PNG = 2

• IMAGE_CODEC_WEBP = 3

• IMAGE_CODEC_HEIF = 4

• IMAGE_CODEC_AWEBP = 5

• IMAGE_CODEC_GIF = 6

Used in: MediaMetadata

• ImageCodecFormat codecFormat = 1

  enum

Used in: LegacyMediaSource

• string url = 1

• uint64 expirySeconds = 2

• MediaUrlType type = 3

• string region = 4

Used in: MediaMetadata

• string sourceMediaId = 1

• optional LegacyDirectDownloadUrl directDownloadUrl = 2

Used in: MediaMetadata, ThumbnailInfo, transcription.TranscriptionInfo

• uint64 mediaListId = 1

• Metadata_MediaType type = 2

• Orientation orientation = 3

• optional crypto.MediaEncryptionInfo encryptionInfoV1 = 4

• optional MediaMetadata_MediaDimensions dimensions = 5

• oneof sourceMedia

  * Media duration for videos. This differs than the value in the Duration envelope; which is about playback characteristics. E.g. for videos the Duration envelope might contain "play_once"; whereas MediaMetadata.duration_ms might be 1230 ms. See duration.proto or playback_characteristics.proto for the full documentation of how this works. Clients can use this information to display: 1. Total time information of a progress bar on the fullscreen video player (though that should really be based on the video itself; not this value) 2. Show total time on media before it's clicked (this *should* use this information; to avoid having to download the media). TODO (@ricky-leatham): consider renaming "Duration" to something like "Playback"

  • LegacyMediaSource legacyMediaSource = 6

  • bytes contentDescriptor = 7

• string mediaUrl = 9

• bool hasSound = 12

• bool zipped = 13

• bool frontFacing = 14

• optional MediaReference mediaReference = 17

• optional MediaId mediaId = 18

• optional crypto.MediaEncryptionInfo encryptionInfoV2 = 19

• common.AssetType assetType = 20

  enum

• optional CaptureCharacteristics captureCharacteristics = 21

• DisplayOrientation displayOrientation = 22

• optional AudioMetadata audio = 23

• optional ImageMetadata image = 24

• optional VideoMetadata video = 25

* Height and width of the referenced

Used in: MediaMetadata

• int32 width = 1

• int32 height = 2

Used in: createContentMessage.CreateContentMessageResult, destinationResult.ConversationDestinationResult, ContentEnvelope_MediaReferenceList, MediaMetadata, transcription.AttachTranscription

• string url = 2

• bytes contentObject = 3

• optional VideoDescription videoDescription = 5

• uint64 mediaListId = 6

• MediaReference_ClaimBehavior claimBehavior = 7

• MediaType mediaType = 8

  enum

• string localContentKey = 9

• string localCacheKey = 10

* The "DO_NOT_CLAIM" means that the media, once initially referenced, should have a fixed ttl, and thus it should not be re-claimed on a go-forward basis. For CAN_EXTEND_MEDIA_CLAIM cases, the party delivering the Snap in context should be responsible for making sure there's a claim matching the life cycle of this snap/snapdoc.

Used in: MediaReference

• REFERENCE_CAN_EXTEND_MEDIA_CLAIM = 0

• REFERENCE_DO_NOT_CLAIM = 1

Used in: transcription.AttachTranscriptionResult, updateResult.EraseStoryMediaResult, updateResult.SaveResult

• repeated ContentEnvelope_MediaReferenceList mediaReferenceLists = 1

Used in: MediaReference

• MEDIA_TYPE_UNASSIGNED = 0

• MEDIA_TYPE_OVERLAY = 1

• MEDIA_TYPE_IMAGE = 2

• MEDIA_TYPE_VIDEO = 3

• MEDIA_TYPE_ASSETBUNDLE = 4

• MEDIA_TYPE_AUDIO = 5

• MEDIA_TYPE_ANIMATEDIMAGE = 6

• MEDIA_TYPE_FONT = 7

• MEDIA_TYPE_WEBVIEWCONTENT = 8

• MEDIA_TYPE_VIDEONOAUDIO = 9

• MEDIA_TYPE_SUBTITLES = 10

• MEDIA_TYPE_DATABLOB = 11

Used in: LegacyDirectDownloadUrl

• MEDIA_URL_TYPE_GCS = 0

• MEDIA_URL_TYPE_S3 = 1

• MEDIA_URL_TYPE_UNRECOGNIZED_VALUE = 2

Used in: MediaMetadata

• META_DATA_MEDIA_TYPE_IMAGE = 0

• META_DATA_MEDIA_TYPE_VIDEO = 1

• META_DATA_MEDIA_TYPE_GIF = 2

• META_DATA_MEDIA_TYPE_AUDIO = 3

• META_DATA_MEDIA_TYPE_UNKNOWN = 4

  * UNKNOWN - Some legacy messages do not specify a media type - rather than make an assumption about what they are; we model them explicitly as UNKNOWN. New messages should absolutely not use this value.

* DEPRECATED. Please use DisplayOrientation to specify the display orientation. Orientation for display on the client. Defaults to VERTICAL. Need to continue being populated for supporting backward compatibility.

Used in: MediaMetadata

• ORIENTATION_VERTICAL = 0

• ORIENTATION_HORIZONTAL = 1

Used in: contentEnvelope.ContentEnvelope_Thumbnails

• optional MediaId mediaId = 1

• int32 mediaReferenceListIndex = 2

Used in: VideoMetadata

• VIDEO_CODEC_UNSET = 0

• VIDEO_CODEC_H264 = 1

• VIDEO_CODEC_HEVC = 2

• VIDEO_CODEC_AV1 = 3

• VIDEO_CODEC_VP9 = 4

Used in: MediaReference

• VideoDescription_VideoPlaybackType videoPlaybackType = 1

• VideoDescription_MediaQualityType mediaQualityType = 2

* The higher the value, the higher the media quality.

Used in: VideoDescription

• VIDEO_MEDIA_QUALITY_TYPE_UNKNOWN = 0

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_1 = 100

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_2 = 200

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_3 = 300

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_4 = 400

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_5 = 500

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_6 = 600

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_7 = 700

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_MAX = 5000

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_4_5 = 450

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_2_1 = 210

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_2_2 = 220

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_2_5 = 250

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_3_2 = 320

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_3_5 = 350

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_2_7 = 270

• VIDEO_MEDIA_QUALITY_TYPE_LEVEL_6_5 = 650

Used in: VideoDescription

• VIDEO_UNKNOWN_PLAYBACK_TYPE = 0

• VIDEO_FASTSTART_DISABLED = 1

  * FASTSTART_DISABLED - Can’t progressively stream; since MOOV atom is at the end

• VIDEO_FASTSTART_ENABLED = 2

  * FASTSTART_ENABLED - Capable of progressive streaming; with MOOV atom at the front

• VIDEO_HTTP_STREAMING_DASH = 3

• VIDEO_HTTP_STREAMING_HLS = 4

Used in: VideoMetadata

• VIDEO_FILE_UNSET = 0

• VIDEO_FILE_MP4 = 1

• VIDEO_FILE_FMP4 = 2

Used in: MediaMetadata

• VideoCodecFormat codecFormat = 1

  enum

• VideoFileFormat containerFormat = 2

  enum