amidi, aaudio, and mediandk done

2026-10-24 10:12:30 +00:00 · 2024-08-08 12:27:09 +02:00
parent 66d5815ca7
commit a9c12c3e16
14 changed files with 5473 additions and 3 deletions
@@ -0,0 +1,164 @@
+//+build android
+package mediandk
+
+import "../"
+
+foreign import mediandk "system:mediandk"
+
+AMediaDataSource :: struct{}
+
+/*
+ * AMediaDataSource's callbacks will be invoked on an implementation-defined thread
+ * or thread pool. No guarantees are provided about which thread(s) will be used for
+ * callbacks. For example, |close| can be invoked from a different thread than the
+ * thread invoking |readAt|. As such, the Implementations of AMediaDataSource callbacks
+ * must be threadsafe.
+ */
+
+/**
+ * Called to request data from the given |offset|.
+ *
+ * Implementations should should write up to |size| bytes into
+ * |buffer|, and return the number of bytes written.
+ *
+ * Return 0 if size is zero (thus no bytes are read).
+ *
+ * Return -1 to indicate that end of stream is reached.
+ */
+AMediaDataSourceReadAt :: #type proc "c" (userdata: rawptr, offset: android.off64_t, buffer: rawptr, size: uint) -> int
+
+/**
+ * Called to get the size of the data source.
+ *
+ * Return the size of data source in bytes, or -1 if the size is unknown.
+ */
+AMediaDataSourceGetSize :: #type proc "c" (userdata: rawptr) -> int
+
+/**
+ * Called to close the data source, unblock reads, and release associated
+ * resources.
+ *
+ * The NDK media framework guarantees that after the first |close| is
+ * called, no future callbacks will be invoked on the data source except
+ * for |close| itself.
+ *
+ * Closing a data source allows readAt calls that were blocked waiting
+ * for I/O data to return promptly.
+ *
+ * When using AMediaDataSource as input to AMediaExtractor, closing
+ * has the effect of unblocking slow reads inside of setDataSource
+ * and readSampleData.
+ */
+AMediaDataSourceClose :: #type proc "c" (userdata: rawptr)
+
+/**
+ * Called to get an estimate of the number of bytes that can be read from this data source
+ * starting at |offset| without blocking for I/O.
+ *
+ * Return -1 when such an estimate is not possible.
+ */
+AMediaDataSourceGetAvailableSize :: #type proc "c" (userdata: rawptr, offset: android.off64_t) -> int
+
+
+foreign mediandk {
+	/**
+	 * Create new media data source. Returns NULL if memory allocation
+	 * for the new data source object fails.
+	 *
+	 * Available since API level 28.
+	 */
+	AMediaDataSource_new :: proc() -> ^AMediaDataSource ---
+
+	/**
+	* Create new media data source. Returns NULL if memory allocation
+	* for the new data source object fails.
+	*
+	* Set the |uri| from which the data source will read,
+	* plus additional http headers when initiating the request.
+	*
+	* Headers will contain corresponding items from |key_values|
+	* in the following fashion:
+	*
+	* key_values[0]:key_values[1]
+	* key_values[2]:key_values[3]
+	* ...
+	* key_values[(numheaders - 1) * 2]:key_values[(numheaders - 1) * 2 + 1]
+	*
+	* Available since API level 29.
+	*/
+	AMediaDataSource_newUri :: proc(uri: cstring, numheaders: i32, key_values: ^[^]u8) -> ^AMediaDataSource ---
+
+	/**
+	* Delete a previously created media data source.
+	*
+	* Available since API level 28.
+	*/
+	AMediaDataSource_delete :: proc(ds: ^AMediaDataSource) ---
+
+	/**
+	* Set an user provided opaque handle. This opaque handle is passed as
+	* the first argument to the data source callbacks.
+	*
+	* Available since API level 28.
+	*/
+	AMediaDataSource_setUserdata :: proc(ds: ^AMediaDataSource, userdata: rawptr) ---
+
+	/**
+	* Set a custom callback for supplying random access media data to the
+	* NDK media framework.
+	*
+	* Implement this if your app has special requirements for the way media
+	* data is obtained, or if you need a callback when data is read by the
+	* NDK media framework.
+	*
+	* Please refer to the definition of AMediaDataSourceReadAt for
+	* additional details.
+	*
+	* Available since API level 28.
+	*/
+	AMediaDataSource_setReadAt :: proc(ds: ^AMediaDataSource, cb: AMediaDataSourceReadAt) ---
+
+	/**
+	* Set a custom callback for supplying the size of the data source to the
+	* NDK media framework.
+	*
+	* Please refer to the definition of AMediaDataSourceGetSize for
+	* additional details.
+	*
+	* Available since API level 28.
+	*/
+	AMediaDataSource_setGetSize :: proc(ds: ^AMediaDataSource, cb: AMediaDataSourceGetSize) ---
+
+	/**
+	* Set a custom callback to receive signal from the NDK media framework
+	* when the data source is closed.
+	*
+	* Please refer to the definition of AMediaDataSourceClose for
+	* additional details.
+	*
+	* Available since API level 28.
+	*/
+	AMediaDataSource_setClose :: proc(ds: ^AMediaDataSource, cb: AMediaDataSourceClose) ---
+
+	/**
+	* Close the data source, unblock reads, and release associated resources.
+	*
+	* Please refer to the definition of AMediaDataSourceClose for
+	* additional details.
+	*
+	* Available since API level 29.
+	*/
+	AMediaDataSource_close :: proc(ds: ^AMediaDataSource) ---
+
+	/**
+	* Set a custom callback for supplying the estimated number of bytes
+	* that can be read from this data source starting at an offset without
+	* blocking for I/O.
+	*
+	* Please refer to the definition of AMediaDataSourceGetAvailableSize
+	* for additional details.
+	*
+	* Available since API level 29.
+	*/
+	AMediaDataSource_setGetAvailableSize :: proc(ds: ^AMediaDataSource, cb: AMediaDataSourceGetAvailableSize) ---
+}