net.majorkernelpanic.streaming.video

Class VideoStream

java.lang.Object

net.majorkernelpanic.streaming.MediaStream

net.majorkernelpanic.streaming.video.VideoStream

All Implemented Interfaces:

Stream

Direct Known Subclasses:

H263Stream, H264Stream

public abstract class VideoStream
extends MediaStream

Don't use this class directly.

Field Summary

Fields inherited from class net.majorkernelpanic.streaming.MediaStream

MODE_MEDIACODEC_API, MODE_MEDIACODEC_API_2, MODE_MEDIARECORDER_API, PIPE_API_LS, PIPE_API_PFD

Constructor Summary

Constructors

Constructor and Description
VideoStream() Don't use this class directly.
VideoStream(int camera) Don't use this class directly

Method Summary

Modifier and Type	Method and Description
void	configure() Configures the stream.
int	getCamera() Returns the id of the camera currently selected.
boolean	getFlashState() Indicates whether or not the flash of the phone is on.
abstract java.lang.String	getSessionDescription() Returns a description of the stream using SDP.
VideoQuality	getVideoQuality() Returns the quality of the stream.
void	setCamera(int camera) Sets the camera that will be used to capture video.
void	setFlashState(boolean state) Turns the LED on or off if phone has one.
void	setPreferences(SharedPreferences prefs) Some data (SPS and PPS params) needs to be stored when getSessionDescription() is called
void	setPreviewOrientation(int orientation) Sets the orientation of the preview.
void	setSurfaceView(SurfaceView view) Sets a Surface to show a preview of recorded media (video).
void	setVideoQuality(VideoQuality videoQuality) Sets the configuration of the stream.
void	start() Starts the stream.
void	startPreview()
void	stop() Stops the stream.
void	stopPreview() Stops the preview.
void	switchCamera() Switch between the front facing and the back facing camera of the phone.
void	toggleFlash() Toggles the LED of the phone if it has one.

Methods inherited from class net.majorkernelpanic.streaming.MediaStream

getBitrate, getDestinationPorts, getLocalPorts, getPacketizer, getSSRC, getStreamingMethod, isStreaming, setDestinationAddress, setDestinationPorts, setDestinationPorts, setOutputStream, setStreamingMethod, setTimeToLive

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VideoStream

public VideoStream()

Don't use this class directly. Uses CAMERA_FACING_BACK by default.

VideoStream

public VideoStream(int camera)

Don't use this class directly

Parameters:

camera - Can be either CameraInfo.CAMERA_FACING_BACK or CameraInfo.CAMERA_FACING_FRONT

Method Detail

setCamera

public void setCamera(int camera)

Sets the camera that will be used to capture video. You can call this method at any time and changes will take effect next time you start the stream.

Parameters:

camera - Can be either CameraInfo.CAMERA_FACING_BACK or CameraInfo.CAMERA_FACING_FRONT

switchCamera

public void switchCamera()
                  throws java.lang.RuntimeException,
                         java.io.IOException

Switch between the front facing and the back facing camera of the phone. If startPreview() has been called, the preview will be briefly interrupted. If start() has been called, the stream will be briefly interrupted. You should not call this method from the main thread if you are already streaming.

Throws:

java.io.IOException

java.lang.RuntimeException

getCamera

public int getCamera()

Returns the id of the camera currently selected. Can be either CameraInfo#CAMERA_FACING_BACK or CameraInfo#CAMERA_FACING_FRONT.

setSurfaceView

public void setSurfaceView(SurfaceView view)

Sets a Surface to show a preview of recorded media (video). You can call this method at any time and changes will take effect next time you call start().

setFlashState

public void setFlashState(boolean state)

Turns the LED on or off if phone has one.

toggleFlash

public void toggleFlash()

Toggles the LED of the phone if it has one. You can get the current state of the flash with getFlashState().

getFlashState

public boolean getFlashState()

Indicates whether or not the flash of the phone is on.

setPreviewOrientation

public void setPreviewOrientation(int orientation)

Sets the orientation of the preview.

Parameters:

orientation - The orientation of the preview

setVideoQuality

public void setVideoQuality(VideoQuality videoQuality)

Sets the configuration of the stream. You can call this method at any time and changes will take effect next time you call configure().

Parameters:

videoQuality - Quality of the stream

getVideoQuality

public VideoQuality getVideoQuality()

Returns the quality of the stream.

setPreferences

public void setPreferences(SharedPreferences prefs)

Some data (SPS and PPS params) needs to be stored when getSessionDescription() is called

Parameters:

prefs - The SharedPreferences that will be used to save SPS and PPS parameters

configure

public void configure()
               throws java.lang.IllegalStateException,
                      java.io.IOException

Configures the stream. You need to call this before calling getSessionDescription() to apply your configuration of the stream.

Specified by:

configure in interface Stream

Overrides:

configure in class MediaStream

Throws:

java.lang.IllegalStateException

java.io.IOException

start

public void start()
           throws java.lang.IllegalStateException,
                  java.io.IOException

Starts the stream. This will also open the camera and display the preview if startPreview() has not already been called.

Specified by:

start in interface Stream

Overrides:

start in class MediaStream

Throws:

java.lang.IllegalStateException

java.io.IOException

stop

public void stop()

Stops the stream.

Specified by:

stop in interface Stream

Overrides:

stop in class MediaStream

startPreview

public void startPreview()
                  throws CameraInUseException,
                         InvalidSurfaceException,
                         java.lang.RuntimeException

Throws:

CameraInUseException

InvalidSurfaceException

java.lang.RuntimeException

stopPreview

public void stopPreview()

Stops the preview.

getSessionDescription

public abstract java.lang.String getSessionDescription()
                                                throws java.lang.IllegalStateException

Returns a description of the stream using SDP. This method can only be called after Stream.configure().

Specified by:

getSessionDescription in interface Stream

Specified by:

getSessionDescription in class MediaStream

Throws:

java.lang.IllegalStateException - Thrown when Stream.configure() wa not called.