/**@class android.os.DropBoxManager @extends java.lang.Object Enqueues chunks of data (from various sources -- application crashes, kernel log records, etc.). The queue is size bounded and will drop old data if the enqueued data exceeds the maximum size. You can think of this as a persistent, system-wide, blob-oriented "logcat". <p>You can obtain an instance of this class by calling {@link android.content.Context#getSystemService} with {@link android.content.Context#DROPBOX_SERVICE}. <p>DropBoxManager entries are not sent anywhere directly, but other system services and debugging tools may scan and upload entries for processing. */ var DropBoxManager = { /**Flag value: Entry's content was deleted to save space. */ IS_EMPTY : "1", /**Flag value: Content is human-readable UTF-8 text (can be combined with IS_GZIPPED). */ IS_TEXT : "2", /**Flag value: Content can be decompressed with {@link java.util.zip.GZIPOutputStream}. */ IS_GZIPPED : "4", /** Broadcast Action: This is broadcast when a new entry is added in the dropbox. You must hold the {@link android.Manifest.permission#READ_LOGS} permission in order to receive this broadcast. <p class="note">This is a protected intent that can only be sent by the system. */ ACTION_DROPBOX_ENTRY_ADDED : "android.intent.action.DROPBOX_ENTRY_ADDED", /** Extra for {@link android.os.DropBoxManager#ACTION_DROPBOX_ENTRY_ADDED}: string containing the dropbox tag. */ EXTRA_TAG : "tag", /** Extra for {@link android.os.DropBoxManager#ACTION_DROPBOX_ENTRY_ADDED}: long integer value containing time (in milliseconds since January 1, 1970 00:00:00 UTC) when the entry was created. */ EXTRA_TIME : "time", /**Stores human-readable text. The data may be discarded eventually (or even immediately) if space is limited, or ignored entirely if the tag has been blocked (see {@link #isTagEnabled}). @param {String} tag describing the type of entry being stored @param {String} data value to store */ addText : function( ) {}, /**Stores binary data, which may be ignored or discarded as with {@link #addText}. @param {String} tag describing the type of entry being stored @param {Object {byte[]}} data value to store @param {Number} flags describing the data */ addData : function( ) {}, /**Stores the contents of a file, which may be ignored or discarded as with {@link #addText}. @param {String} tag describing the type of entry being stored @param {Object {File}} file to read from @param {Number} flags describing the data @throws IOException if the file can't be opened */ addFile : function( ) {}, /**Checks any blacklists (set in system settings) to see whether a certain tag is allowed. Entries with disabled tags will be dropped immediately, so you can save the work of actually constructing and sending the data. @param {String} tag that would be used in {@link #addText} or {@link #addFile} @return {Boolean} whether events with that tag would be accepted */ isTagEnabled : function( ) {}, /**Gets the next entry from the drop box <em>after</em> the specified time. Requires <code>android.permission.READ_LOGS</code>. You must always call {@link android.os.DropBoxManager.Entry#close()} on the return value! @param {String} tag of entry to look for, null for all tags @param {Number} msec time of the last entry seen @return {Object {android.os.DropBoxManager.Entry}} the next entry, or null if there are no more entries */ getNextEntry : function( ) {}, };