api: add sxplayer_release_frame_mediacodec()

sxplayer.c

@@ -547,6 +547,27 @@ void sxplayer_release_frame(struct sxplayer_frame *frame)
     }
 }
 
+int sxplayer_release_frame_mediacodec(struct sxplayer_frame **framep)
+{
+#ifdef HAVE_MEDIACODEC_HWACCEL
+    if (!*framep)
+        return 0;
+    struct sxplayer_frame *frame = *framep;
+    av_assert0(frame->pix_fmt == SXPLAYER_PIXFMT_MEDIACODEC);
+    AVMediaCodecBuffer *buffer = (AVMediaCodecBuffer *)frame->data;
+    int ret = av_mediacodec_release_buffer(buffer, 1);
+    sxplayer_release_frame(frame);
+    *framep = NULL;
+    if (ret < 0) {
+        LOG(s, ERROR, "Failed to release MediaCodec buffer: %s", av_err2str(ret));
+        return -1;
+    }
+    return 0;
+#else
+    av_assert0(0);
+#endif
+}
+
 int sxplayer_set_drop_ref(struct sxplayer_ctx *s, int drop)
 {
     return -1; // TODO

sxplayer.h.in

@@ -336,6 +336,21 @@ int sxplayer_set_drop_ref(struct sxplayer_ctx *s, int drop);
 /* Release a frame obtained with sxplayer_get_frame() */
 void sxplayer_release_frame(struct sxplayer_frame *frame);
 
+/**
+ * Render to surface and release a MediaCodec frame obtained with
+ * sxplayer_get_frame().
+ *
+ * @param framep the address of a sxplayer_frame pointer to be rendered
+ *               and released
+ *
+ * Note: the sxplayer_frame is released even if the underlying MediaCodec
+ * failed to be rendered.
+ *
+ * Return 0 on success, a negative value on error
+ *
+ */
+int sxplayer_release_frame_mediacodec(struct sxplayer_frame **framep);
+
 /* Close and free everything */
 void sxplayer_free(struct sxplayer_ctx **ss);