mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-22 16:26:39 +00:00
ae3ed25025
To allow code from dash_demux.c to be used by other elements that are based upon GstAdaptiveDemux, the code has been refactored into four new files: adaptive_demux_engine.[ch] adaptive_demux_common.[ch] The code in adaptive_demux_engine.c provides a generic test engine for elements based upon GstAdaptiveDemux. The code in adaptive_demux_common.c provides a set of utility functions that are common between the tests for hlsdemux and dashdemux. As part of the refactoring, variables in structures were renamed from using camelCase to underscore_case to match other GStreamer source code. The fake_http_src was renamed test_http_src and changed to use callbacks to provide input data and error conditions. Rather than using an array of input data that tries to encode all the possible use cases for the GstTestHTTPSrc element, use a struct of callbacks. Users of this element are obliged to implement at least the src_start callback, which provides a way to link from a URI to the settings for that URI.
132 lines
5 KiB
C
132 lines
5 KiB
C
/* HTTP source element for use in tests
|
|
*
|
|
* Copyright (c) <2015> YouView TV Ltd
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __GST_TEST_HTTP_SRC_H__
|
|
#define __GST_TEST_HTTP_SRC_H__
|
|
|
|
#include <gst/gst.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GST_TYPE_TEST_HTTP_SRC (gst_test_http_src_get_type ())
|
|
|
|
/* structure used by src_start function to configure the
|
|
* GstTestHTTPSrc plugin.
|
|
* It specifies information about a given URI.
|
|
*/
|
|
typedef struct _GstTestHTTPSrcInput
|
|
{
|
|
gpointer context; /* opaque pointer that can be used in callbacks */
|
|
guint64 size; /* size of resource, in bytes */
|
|
GstStructure *request_headers;
|
|
GstStructure *response_headers;
|
|
guint status_code; /* HTTP status code */
|
|
} GstTestHTTPSrcInput;
|
|
|
|
/* Opaque structure used by GstTestHTTPSrc */
|
|
typedef struct _GstTestHTTPSrc GstTestHTTPSrc;
|
|
|
|
typedef struct _GstTestHTTPSrcCallbacks {
|
|
/**
|
|
* src_start:
|
|
* @src: The #GstTestHTTPSrc calling this callback
|
|
* @uri: The URI that is being requested
|
|
* @input_data: (out) The implementation of this callback is
|
|
* responsible for filling in this #GstTestHTTPSrcInput
|
|
* with the appropriate information, return returning %TRUE.
|
|
* If returning %FALSE, only GstTestHTTPSrcInput::status_code
|
|
* should be updated.
|
|
* Returns: %TRUE if GstTestHTTPSrc should respond to this URI,
|
|
* using the supplied input_data.
|
|
*
|
|
* src_start is used to "open" the given URI. The callback must return
|
|
* %TRUE to simulate a success, and set appropriate fields in input_data.
|
|
* Returning %FALSE indicates that the request URI is not found.
|
|
* In this situation GstTestHTTPSrc will cause the appropriate
|
|
* 404 error to be posted to the bus
|
|
*/
|
|
gboolean (*src_start)(GstTestHTTPSrc *src,
|
|
const gchar *uri,
|
|
GstTestHTTPSrcInput *input_data,
|
|
gpointer user_data);
|
|
/**
|
|
* src_create:
|
|
* @src: the #GstTestHTTPSrc calling this callback
|
|
* @offset: the offset from the start of the resource
|
|
* @length: requested number of bytes
|
|
* @retbuf: (out) used to return a newly allocated #GstBuffer
|
|
* @context: (allow none) the value of the context field
|
|
* in #GstTestHTTPSrcInput.
|
|
* @user_data: the value of user_data provided to
|
|
* #gst_test_http_src_install_callbacks
|
|
* Returns: %GST_FLOW_OK to indicate success, or some other value of
|
|
* #GstFlowReturn to indicate EOS or error.
|
|
*
|
|
* The src_create function is used to create a #GstBuffer for
|
|
* simulating the data that is returned when accessing this
|
|
* "open" stream. It can also be used to simulate various error
|
|
* conditions by returning something other than %GST_FLOW_OK
|
|
*/
|
|
GstFlowReturn (*src_create)(GstTestHTTPSrc *src,
|
|
guint64 offset,
|
|
guint length,
|
|
GstBuffer ** retbuf,
|
|
gpointer context,
|
|
gpointer user_data);
|
|
} GstTestHTTPSrcCallbacks;
|
|
|
|
GType gst_test_http_src_get_type (void);
|
|
|
|
/**
|
|
* gst_test_http_src_register_plugin:
|
|
* @registry: the #GstRegistry to use for registering this plugin
|
|
* @name: the name to use for this plugin
|
|
* Returns: true if successful
|
|
*
|
|
* Registers this plugin with the GstRegitry using the given name. It will
|
|
* be given a high rank, so that it will be picked in preference to any
|
|
* other element that implements #GstURIHandler.
|
|
*/
|
|
gboolean gst_test_http_src_register_plugin (GstRegistry * registry, const gchar * name);
|
|
|
|
/**
|
|
* gst_test_http_src_install_callbacks:
|
|
* @callbacks: the #GstTestHTTPSrcCallbacks callback functions that will
|
|
* be called every time this element is asked to open a URI or provide data
|
|
* for an open URI.
|
|
* @user_data: a pointer that is passed to every callback
|
|
*/
|
|
void gst_test_http_src_install_callbacks (const GstTestHTTPSrcCallbacks *callbacks, gpointer user_data);
|
|
|
|
/**
|
|
* gst_test_http_src_set_default_blocksize:
|
|
* @blocksize: the default block size to use (0=use #GstBaseSrc default)
|
|
*
|
|
* Set the default blocksize that will be used by instances of
|
|
* #GstTestHTTPSrc. It specifies the size (in bytes) that will be
|
|
* returned in each #GstBuffer. This default can be overridden
|
|
* by an instance of #GstTestHTTPSrc using the "blocksize" property
|
|
* of #GstBaseSrc
|
|
*/
|
|
void gst_test_http_src_set_default_blocksize (guint blocksize);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GST_TEST_HTTP_SRC_H__ */
|