/**@class android.provider.MediaStore.MediaColumns implements android.provider.BaseColumns Common media metadata columns. */ var MediaColumns = { /** Absolute filesystem path to the media item on disk. <p> Note that apps may not have filesystem permissions to directly access this path. Instead of trying to open this path directly, apps should use {@link ContentResolver#openFileDescriptor(Uri, String)} to gain access. @deprecated Apps may not have filesystem permissions to directly access this path. Instead of trying to open this path directly, apps should use {@link ContentResolver#openFileDescriptor(Uri, String)} to gain access. */ DATA : "_data", /** Hash of the media item on disk. <p> Contains a 20-byte binary blob which is the SHA-1 hash of the file as persisted on disk. For performance reasons, the hash may not be immediately available, in which case a {@code NULL} value will be returned. If the underlying file is modified, this value will be cleared and recalculated. <p> If you require the hash of a specific item, you can call {@link ContentResolver#canonicalize(Uri)}, which will block until the hash is calculated. @removed */ HASH : "_hash", /** The size of the media item. */ SIZE : "_size", /** The display name of the media item. <p> For example, an item stored at {@code /storage/0000-0000/DCIM/Vacation/IMG1024.JPG} would have a display name of {@code IMG1024.JPG}. */ DISPLAY_NAME : "_display_name", /** The title of the media item. */ TITLE : "title", /** The time the media item was first added. */ DATE_ADDED : "date_added", /** The time the media item was last modified. */ DATE_MODIFIED : "date_modified", /** The time the media item was taken. */ DATE_TAKEN : "datetaken", /** The MIME type of the media item. <p> This is typically defined based on the file extension of the media item. However, it may be the value of the {@code format} attribute defined by the <em>Dublin Core Media Initiative</em> standard, extracted from any XMP metadata contained within this media item. <p class="note"> Note: the {@code format} attribute may be ignored if the top-level MIME type disagrees with the file extension. For example, it's reasonable for an {@code image/jpeg} file to declare a {@code format} of {@code image/vnd.google.panorama360+jpg}, but declaring a {@code format} of {@code audio/ogg} would be ignored. <p> This is a read-only column that is automatically computed. */ MIME_TYPE : "mime_type", /** The MTP object handle of a newly transfered file. Used to pass the new file's object handle through the media scanner from MTP to the media provider For internal use only by MTP, media scanner and media provider. @hide */ MEDIA_SCANNER_NEW_OBJECT_ID : "media_scanner_new_object_id", /** Non-zero if the media file is drm-protected @hide */ IS_DRM : "is_drm", /** Flag indicating if a media item is pending, and still being inserted by its owner. While this flag is set, only the owner of the item can open the underlying file; requests from other apps will be rejected. @see MediaStore#setIncludePending(Uri) */ IS_PENDING : "is_pending", /** Flag indicating if a media item is trashed. @see MediaColumns#IS_TRASHED @see MediaStore#setIncludeTrashed(Uri) @see MediaStore#trash(Context, Uri) @see MediaStore#untrash(Context, Uri) @removed */ IS_TRASHED : "is_trashed", /** The time the media item should be considered expired. Typically only meaningful in the context of {@link #IS_PENDING}. */ DATE_EXPIRES : "date_expires", /** The width of the media item, in pixels. */ WIDTH : "width", /** The height of the media item, in pixels. */ HEIGHT : "height", /** Package name that contributed this media. The value may be {@code NULL} if ownership cannot be reliably determined. */ OWNER_PACKAGE_NAME : "owner_package_name", /** Volume name of the specific storage device where this media item is persisted. The value is typically one of the volume names returned from {@link android.provider.MediaStore#getExternalVolumeNames(Context)}. <p> This is a read-only column that is automatically computed. */ VOLUME_NAME : "volume_name", /** Relative path of this media item within the storage device where it is persisted. For example, an item stored at {@code /storage/0000-0000/DCIM/Vacation/IMG1024.JPG} would have a path of {@code DCIM/Vacation/}. <p> This value should only be used for organizational purposes, and you should not attempt to construct or access a raw filesystem path using this value. If you need to open a media item, use an API like {@link ContentResolver#openFileDescriptor(Uri, String)}. <p> When this value is set to {@code NULL} during an {@link ContentResolver#insert} operation, the newly created item will be placed in a relevant default location based on the type of media being inserted. For example, a {@code image/jpeg} item will be placed under {@link Environment#DIRECTORY_PICTURES}. <p> You can modify this column during an {@link ContentResolver#update} call, which will move the underlying file on disk. <p> In both cases above, content must be placed under a top-level directory that is relevant to the media type. For example, attempting to place a {@code audio/mpeg} file under {@link Environment#DIRECTORY_PICTURES} will be rejected. */ RELATIVE_PATH : "relative_path", /** The primary directory name this media exists under. The value may be {@code NULL} if the media doesn't have a primary directory name. @removed @deprecated Replaced by {@link #RELATIVE_PATH}. */ PRIMARY_DIRECTORY : "primary_directory", /** The secondary directory name this media exists under. The value may be {@code NULL} if the media doesn't have a secondary directory name. @removed @deprecated Replaced by {@link #RELATIVE_PATH}. */ SECONDARY_DIRECTORY : "secondary_directory", /** The primary bucket ID of this media item. This can be useful to present the user a first-level clustering of related media items. This is a read-only column that is automatically computed. */ BUCKET_ID : "bucket_id", /** The primary bucket display name of this media item. This can be useful to present the user a first-level clustering of related media items. This is a read-only column that is automatically computed. */ BUCKET_DISPLAY_NAME : "bucket_display_name", /** The group ID of this media item. This can be useful to present the user a grouping of related media items, such a burst of images, or a {@code JPG} and {@code DNG} version of the same image. <p> This is a read-only column that is automatically computed based on the first portion of the filename. For example, {@code IMG1024.BURST001.JPG} and {@code IMG1024.BURST002.JPG} will have the same {@link #GROUP_ID} because the first portion of their filenames is identical. @removed */ GROUP_ID : "group_id", /** The "document ID" GUID as defined by the <em>XMP Media Management</em> standard, extracted from any XMP metadata contained within this media item. The value is {@code null} when no metadata was found. <p> Each "document ID" is created once for each new resource. Different renditions of that resource are expected to have different IDs. */ DOCUMENT_ID : "document_id", /** The "instance ID" GUID as defined by the <em>XMP Media Management</em> standard, extracted from any XMP metadata contained within this media item. The value is {@code null} when no metadata was found. <p> This "instance ID" changes with each save operation of a specific "document ID". */ INSTANCE_ID : "instance_id", /** The "original document ID" GUID as defined by the <em>XMP Media Management</em> standard, extracted from any XMP metadata contained within this media item. <p> This "original document ID" links a resource to its original source. For example, when you save a PSD document as a JPEG, then convert the JPEG to GIF format, the "original document ID" of both the JPEG and GIF files is the "document ID" of the original PSD file. */ ORIGINAL_DOCUMENT_ID : "original_document_id", /** The duration of the media item. */ DURATION : "duration", /** The orientation for the media item, expressed in degrees. For example, 0, 90, 180, or 270 degrees. */ ORIENTATION : "orientation", };