Package io.humble.video.customio

An API for extending Humble Video to read and write from arbitrary data sources.

See: Description

Interface Summary

Interface	Description
IURLProtocolHandler	Interface that Humble Video native code calls back to for each URL.
IURLProtocolHandlerFactory	Used by URLProtocolManager to get a factory for a given protocol.
IURLProtocolRegistrar	For Internal Use Only.

Class Summary

Class	Description
DataInputOutputHandler	Implementation of URLProtocolHandler that can read from DataInput objects or write to DataOutput objects.
FfmpegIO	For Internal Use Only.
FfmpegIOHandle	For Internal Use Only.
FileProtocolHandler	Implementation of URLProtocolHandler that can read and write files.
FileProtocolHandlerFactory	Implementation of IURLProtocolHandlerFactory that demonstrates how you can have Java act just like FFMPEG's internal "file:" protocol.
Helper	For Internal Use Only.
HumbleIO	Allows Humble Video to read from and write to many different types of Java I/O objects, plus custom IURLProtocolHandler objects.
InputOutputStreamHandler	Implementation of URLProtocolHandler that can read from InputStream objects or write to OutputStream objects.
NullProtocolHandler	The NullProtocolHandler implements IURLProtocolHandler, but discards any data written and always returns 0 for reading.
NullProtocolHandlerFactory	Returns a new NullProtocolHandler factory.
ReadableWritableChannelHandler	Implementation of URLProtocolHandler that can read from ReadableByteChannel objects or write to WritableByteChannel object.
URLProtocolManager	This class manages URL protocols that we have handlers for.

Package io.humble.video.customio Description

An API for extending Humble Video to read and write from arbitrary data sources.

Humble Video needs to process raw media file data in order to decode and encode those files. What's worse, is the only input Humble Video can give to FFMPEG is a URL.

By default, Humble Video can read any "file:" URL. In fact if you don't specify a protocol, we will assume "file:". But what happens if you want to read data from an arbitrary source (like FMS, Red5, Wowza, etc)?

That's where this package comes in. Using the IO package you can implement a IURLProtocolHandler that can respond to FFMPEG requests to read or write buffers. From there any type of integration is possible.

To begin with this class, see URLProtocolManager and take a look at the example source code for FileProtocolHandler and FileProtocolHandlerFactory classes.