WOWZCameraView (GoCoder SDK Android API)

java.lang.Object
- SurfaceView
- - com.wowza.gocoder.sdk.api.devices.WOWZCameraView

All Implemented Interfaces:

WOWZBroadcastAPI.AdaptiveBroadcaster, WOWZBroadcastAPI.Broadcaster, WOWZBroadcastAPI.VideoBroadcaster
```
public class WOWZCameraView
extends SurfaceView
implements WOWZBroadcastAPI.VideoBroadcaster, WOWZBroadcastAPI.AdaptiveBroadcaster
```
The WOWZCameraView class is a custom class for previewing the video captured from a camera.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface WOWZCameraView.PreviewStatusListener
Callback interface to use with setPreviewStatusListener(PreviewStatusListener).

Nested Classes
Modifier and Type	Class and Description
`static interface`	`WOWZCameraView.PreviewStatusListener` Callback interface to use with `setPreviewStatusListener(PreviewStatusListener)`.

Field Summary

Fields
Modifier and Type Field and Description

static int EXTENSION_BLACK_AND_WHITE

static int EXTENSION_DEFAULT

static int EXTENSION_MIRROR

Fields
Modifier and Type	Field and Description
`static int`	`EXTENSION_BLACK_AND_WHITE`
`static int`	`EXTENSION_DEFAULT`
`static int`	`EXTENSION_MIRROR`

Constructor Summary

Constructors
Constructor and Description
`WOWZCameraView(Context context)` Simple constructor to use when creating a view from code.
`WOWZCameraView(Context context, AttributeSet attrs)` Called when inflating a view from XML.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`changeAdaptiveBitrate(int bitrate)`
`void`	`changeAdaptiveFramerate(int framerate)`
`void`	`clearView()` Clears the currently rendered frame from the view.
`void`	`doConfigChange()`
`WOWZSize`	`getActiveFrameSize()` Gets the active video frame size, which may differ from the requested frame size if the current scale mode is FILL_VIEW.
`int`	`getAdaptiveBitrate()`
`int`	`getAdaptiveFramerate()`
`static WOWZCamera[]`	`getAvailableDeviceCameras()` Deprecated. Use `WOWZCamera.getAvailableDeviceCameras()` instead.
`WOWZBroadcastConfig`	`getBroadcastConfig()` Gets the configuration settings for an active broadcast session.
`WOWZBroadcastAPI.VideoBroadcaster`	`getBroadcaster()` Deprecated. The WOWZCameraView class now implements the `WOWZBroadcastAPI.VideoBroadcaster` interface so you can use a WOWZCameraView instance directly in `WOWZBroadcastConfig.setVideoBroadcaster(WOWZBroadcastAPI.VideoBroadcaster)`, for example, `broadcastConfig.setVideoBroadcaster(cameraView);`.
`WOWZStatus`	`getBroadcasterStatus()` Gets the status for a broadcast component.
`WOWZCamera`	`getCamera()` Gets the active camera.
`WOWZCamera`	`getCameraByDirection(int direction)` Gets a camera instance based on its ID specifier
`WOWZCamera`	`getCameraById(int cameraId)` Gets a camera instance based on its ID specifier.
`static java.lang.String`	`getCameraInfo()` Deprecated. Use `WOWZCamera.getCameraInfo()` instead.
`WOWZCamera[]`	`getCameras()` Gets an array of `WOWZCamera` instances for each camera device present.
`static WOWZCamera[]`	`getDeviceCameras()` Deprecated. Use `WOWZCamera.getDeviceCameras()` instead.
`int`	`getDeviceOrientation()` Deprecated. Use `WOWZDeviceUtils.getDeviceOrientation(Context)` instead.
`int`	`getFramerate()` Gets the currently configured video frame rate.
`WOWZSize`	`getFrameSize()` Gets the currently configured video frame size.
`static int`	`getNumberOfDeviceCameras()` Deprecated. Use `WOWZCamera.getNumberOfDeviceCameras()` instead.
`WOWZCamera`	`getOtherCamera()` Gets the camera that isn't currently active, if present.
`int`	`getOtherCameraId()` Gets the ID of the camera that isn't currently active, if present.
`WOWZStatus`	`getPreviewStatus()` Gets this view's preview status.
`int`	`getScaleMode()`
`WOWZSize`	`getScreenSize()` Gets the size of camera preview display.
`WOWZStatus`	`getStatus()` Deprecated. Use `getPreviewStatus()` instead.
`WOWZColor`	`getVideoBackgroundColor()`
`WOWZMediaConfig`	`getVideoSourceConfig()` Gets configuration information for the video source.
`boolean`	`isPaused()` Deprecated. Use `isPreviewPaused()` instead.
`boolean`	`isPreviewing()` Checks whether the camera preview display is active.
`boolean`	`isPreviewPaused()` Checks whether the camera preview display was paused due to the onPause method begin called.
`boolean`	`isPreviewReady()` Checks whether the camera preview has been fully initialized.
`boolean`	`isSwitchCameraAvailable()` Checks whether the current camera can be switched based on the state of any live streaming broadcast currently active and device presence.
`boolean`	`isSwitchCameraAvailable(WOWZMediaConfig mediaConfig)` Checks whether the current camera can be switched based on the state of any live streaming broadcast currently active and device presence.
`boolean`	`isSwitchCameraAvailable(WOWZSize withFrameSize)` Checks whether the current camera can be switched based on the state of any live streaming broadcast currently active and device presence.
`boolean`	`isVideoEnabled()` Checks whether a video broadcast component is enabled.
`boolean`	`isVideoPaused()` Checks whether a video broadcast component is paused.
`void`	`onConfigurationChanged(Configuration newConfig)` Called when the device configuration changes, typically to detect device orientation changes.
`void`	`onLowMemory()` Called when the overall system is running low on memory and actively running processes should trim their memory usage.
`void`	`onPause()` Called from the activity's `onPause()` method to store the state of the camera preview display before the application is sent to the background.
`void`	`onResume()` Use in conjunction with `onPause()` when called from the activity's `onResume()` method to restart the camera preview display based on the state it was in when the activity was paused and a corresponding call to `onPause()` was made.
`WOWZStatus`	`prepareForBroadcast(WOWZBroadcastConfig broadcastConfig)` Initializes each component of a broadcast.
`void`	`registerFrameListener(WOWZRenderAPI.VideoFrameListener frameListener)` Registers an object instance implementing the `WOWZRenderAPI.VideoFrameListener` interface that can be used to capture content from the camera preview display.
`void`	`registerFrameRenderer(WOWZRenderAPI.VideoFrameRenderer frameRenderer)` Registers an object instance implementing the `WOWZRenderAPI.VideoFrameRenderer` interface that can be used to render additional content, such as a logo, to the camera preview display.
`WOWZCamera`	`setCamera(int cameraId)` Sets the active camera.
`WOWZCamera`	`setCamera(WOWZCamera camera)` Sets the active camera.
`WOWZCamera`	`setCameraByDirection(int direction)` Sets the active camera based on the specified direction (front or back).
`void`	`setCameraConfig(WOWZMediaConfig previewConfig)` Updates the frame size and frame rate for the active camera with the corresponding values from the specified configuration.
`int`	`setFramerate(int framerate)` Updates the frame rate for the active camera with the specified value.
`WOWZSize`	`setFrameSize(int width, int height)` Updates the frame size for the active camera with the specified values.
`WOWZSize`	`setFrameSize(WOWZSize frameSize)` Updates the frame size for the active camera with the specified size.
`void`	`setPreviewReadyListener(WOWZCameraView.PreviewStatusListener previewReadyListener)` Deprecated. Use `setPreviewStatusListener(PreviewStatusListener)` instead.
`void`	`setPreviewStatusListener(WOWZCameraView.PreviewStatusListener previewStatusListener)` Sets the callback instance to receive callback notifications when the camera preview is fully started or stopped or an error occurred in the process.
`void`	`setScaleMode(int scaleMode)`
`void`	`setSurfaceExtension(int extensionType)`
`void`	`setVideoBackgroundColor(WOWZColor videoBackgroundColor)`
`void`	`setVideoEnabled(boolean enabled)` Sets the flag indicating that a video broadcast component is enabled.
`void`	`setVideoPaused(boolean videoPaused)` Sets the flag indicating that a video broadcast component is paused.
`WOWZStatus`	`startBroadcasting()` Called on each broadcast component to begin a live streaming broadcast.
`WOWZCamera`	`startPreview()` Starts the camera preview display.
`WOWZCamera`	`startPreview(WOWZCameraView.PreviewStatusListener previewStatusListener)`
`WOWZCamera`	`startPreview(WOWZMediaConfig cameraConfig)` Starts the camera preview display using the values from the specified configuration for the camera frame size and frame rate.
`WOWZCamera`	`startPreview(WOWZMediaConfig cameraConfig, WOWZCameraView.PreviewStatusListener previewStatusListener)` Starts the camera preview display.
`WOWZStatus`	`stopBroadcasting()` Called on each broadcast component to end a live streaming broadcast.
`WOWZCamera`	`stopPreview()` Stops the camera preview display.
`WOWZCamera`	`stopPreview(WOWZCameraView.PreviewStatusListener previewStatusListener)` Stops the camera preview display.
`void`	`surfaceChanged(SurfaceHolder holder, int format, int width, int height)` Called immediately after any structural changes (format or size) have been made to the surface.
`void`	`surfaceCreated(SurfaceHolder surfaceHolder)` Called immediately after the surface is first created.
`void`	`surfaceDestroyed(SurfaceHolder holder)` Called immediately before a surface is being destroyed.
`WOWZCamera`	`switchCamera()` Changes the active camera being previewed to the alternate device camera, if available.
`void`	`unregisterFrameListener(WOWZRenderAPI.VideoFrameListener frameListener)` Unregisters a frame listener.
`void`	`unregisterFrameRenderer(WOWZRenderAPI.VideoFrameRenderer frameRenderer)` Unregisters a frame listener.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EXTENSION_DEFAULT
```
public static final int EXTENSION_DEFAULT
```
    See Also:
    
    Constant Field Values
  - EXTENSION_MIRROR
```
public static final int EXTENSION_MIRROR
```
    See Also:
    
    Constant Field Values
  - EXTENSION_BLACK_AND_WHITE
```
public static final int EXTENSION_BLACK_AND_WHITE
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - WOWZCameraView
```
public WOWZCameraView(Context context,
                      AttributeSet attrs)
```
    Called when inflating a view from XML.
    
    Parameters:
    
    context - The Context the view is running in, through which it can access the current theme, resources, etc.
    
    attrs - The attributes of the XML tag that is inflating the view.
  - WOWZCameraView
```
public WOWZCameraView(Context context)
```
    Simple constructor to use when creating a view from code.
    
    Parameters:
    
    context - The Context the view is running in, through which it can access the current theme, resources, etc.
- Method Detail
  - getNumberOfDeviceCameras
```
public static int getNumberOfDeviceCameras()
```
    Deprecated. Use WOWZCamera.getNumberOfDeviceCameras() instead.
    
    An alias for WOWZCamera.getNumberOfDeviceCameras()
  - getDeviceCameras
```
public static WOWZCamera[] getDeviceCameras()
```
    Deprecated. Use WOWZCamera.getDeviceCameras() instead.
  - getAvailableDeviceCameras
```
public static WOWZCamera[] getAvailableDeviceCameras()
```
    Deprecated. Use WOWZCamera.getAvailableDeviceCameras() instead.
  - getCameraInfo
```
public static java.lang.String getCameraInfo()
```
    Deprecated. Use WOWZCamera.getCameraInfo() instead.
  - getDeviceOrientation
```
public int getDeviceOrientation()
```
    Deprecated. Use WOWZDeviceUtils.getDeviceOrientation(Context) instead.
  - setPreviewStatusListener
```
public void setPreviewStatusListener(WOWZCameraView.PreviewStatusListener previewStatusListener)
```
    Sets the callback instance to receive callback notifications when the camera preview is fully started or stopped or an error occurred in the process.
    
    Parameters:
    
    previewStatusListener - An object that has implemented the PreviewStatusListener interface.
  - setPreviewReadyListener
```
public void setPreviewReadyListener(WOWZCameraView.PreviewStatusListener previewReadyListener)
```
    Deprecated. Use setPreviewStatusListener(PreviewStatusListener) instead.
  - getPreviewStatus
```
public WOWZStatus getPreviewStatus()
```
    Gets this view's preview status. When the camera preview is active, the status's state property will be WOWZState.RUNNING or WOWZState.IDLE.
    
    Returns:
    
    The camera preview display status.
  - getStatus
```
public WOWZStatus getStatus()
```
    Deprecated. Use getPreviewStatus() instead.
    
    Specified by:
    
    getStatus in interface WOWZBroadcastAPI.Broadcaster
  - isPreviewing
```
public boolean isPreviewing()
```
    Checks whether the camera preview display is active. Equivalent to getPreviewStatus().isRunning() and getPreviewStatus().getState == WOWZState.RUNNING
    
    Returns:
    
    True if the camera preview is active; false otherwise.
  - isPreviewReady
```
public boolean isPreviewReady()
```
    Checks whether the camera preview has been fully initialized.
    
    Returns:
    
    True if the camera preview has been fully initialized; false otherwise.
  - isPreviewPaused
```
public boolean isPreviewPaused()
```
    Checks whether the camera preview display was paused due to the onPause method begin called.
    
    Returns:
    
    True if the camera preview is paused; false otherwise.
  - isPaused
```
public boolean isPaused()
```
    Deprecated. Use isPreviewPaused() instead.
  - getBroadcaster
```
public WOWZBroadcastAPI.VideoBroadcaster getBroadcaster()
```
    Deprecated. The WOWZCameraView class now implements the WOWZBroadcastAPI.VideoBroadcaster interface so you can use a WOWZCameraView instance directly in WOWZBroadcastConfig.setVideoBroadcaster(WOWZBroadcastAPI.VideoBroadcaster), for example, broadcastConfig.setVideoBroadcaster(cameraView);.
  - getVideoBackgroundColor
```
public WOWZColor getVideoBackgroundColor()
```
  - setVideoBackgroundColor
```
public void setVideoBackgroundColor(WOWZColor videoBackgroundColor)
```
  - getVideoSourceConfig
```
public WOWZMediaConfig getVideoSourceConfig()
```
    Description copied from interface: WOWZBroadcastAPI.VideoBroadcaster
    
    Gets configuration information for the video source.
    
    Specified by:
    
    getVideoSourceConfig in interface WOWZBroadcastAPI.VideoBroadcaster
    
    Returns:
    
    The video source configuration.
  - setVideoEnabled
```
public void setVideoEnabled(boolean enabled)
```
    Description copied from interface: WOWZBroadcastAPI.VideoBroadcaster
    
    Sets the flag indicating that a video broadcast component is enabled.
    
    Specified by:
    
    setVideoEnabled in interface WOWZBroadcastAPI.VideoBroadcaster
    
    Parameters:
    
    enabled - True if the component should be enabled; false otherwise.
  - isVideoEnabled
```
public boolean isVideoEnabled()
```
    Description copied from interface: WOWZBroadcastAPI.VideoBroadcaster
    
    Checks whether a video broadcast component is enabled.
    
    Specified by:
    
    isVideoEnabled in interface WOWZBroadcastAPI.VideoBroadcaster
    
    Returns:
    
    True if the component is enabled; false otherwise.
  - setVideoPaused
```
public void setVideoPaused(boolean videoPaused)
```
    Description copied from interface: WOWZBroadcastAPI.VideoBroadcaster
    
    Sets the flag indicating that a video broadcast component is paused.
    
    Specified by:
    
    setVideoPaused in interface WOWZBroadcastAPI.VideoBroadcaster
    
    Parameters:
    
    videoPaused - True if the component should be paused; false otherwise.
  - isVideoPaused
```
public boolean isVideoPaused()
```
    Description copied from interface: WOWZBroadcastAPI.VideoBroadcaster
    
    Checks whether a video broadcast component is paused.
    
    Specified by:
    
    isVideoPaused in interface WOWZBroadcastAPI.VideoBroadcaster
    
    Returns:
    
    True if the component is active; false otherwise.
  - getBroadcastConfig
```
public WOWZBroadcastConfig getBroadcastConfig()
```
    Description copied from interface: WOWZBroadcastAPI.Broadcaster
    
    Gets the configuration settings for an active broadcast session. Only returns a non-null value between calls to prepareForBroadcast() and stopBroadcasting().
    
    Specified by:
    
    getBroadcastConfig in interface WOWZBroadcastAPI.Broadcaster
    
    Returns:
    
    The configuration settings for the active broadcast session or the broadcast session currently being prepared.
  - getBroadcasterStatus
```
public WOWZStatus getBroadcasterStatus()
```
    Description copied from interface: WOWZBroadcastAPI.Broadcaster
    
    Gets the status for a broadcast component.
    
    Specified by:
    
    getBroadcasterStatus in interface WOWZBroadcastAPI.Broadcaster
  - prepareForBroadcast
```
public WOWZStatus prepareForBroadcast(WOWZBroadcastConfig broadcastConfig)
```
    Description copied from interface: WOWZBroadcastAPI.Broadcaster
    
    Initializes each component of a broadcast. Upon successful initialization, each component must set its status to WOWZState.READY or WOWZState.IDLE and also indicate the error in the status.
    
    Specified by:
    
    prepareForBroadcast in interface WOWZBroadcastAPI.Broadcaster
    
    Parameters:
    
    broadcastConfig - The broadcast configuration.
    
    Returns:
    
    The status after transitioning each broadcast component to WOWZState.READY.
  - startBroadcasting
```
public WOWZStatus startBroadcasting()
```
    Description copied from interface: WOWZBroadcastAPI.Broadcaster
    
    Called on each broadcast component to begin a live streaming broadcast. Upon success, each component must set its status to WOWZState.RUNNING or WOWZState.IDLE and also indicate the error in the status.
    
    Specified by:
    
    startBroadcasting in interface WOWZBroadcastAPI.Broadcaster
    
    Returns:
    
    The status after transitioning each broadcast component to WOWZState.RUNNING.
  - stopBroadcasting
```
public WOWZStatus stopBroadcasting()
```
    Description copied from interface: WOWZBroadcastAPI.Broadcaster
    
    Called on each broadcast component to end a live streaming broadcast. Upon success, each component must set its status to WOWZState.IDLE.
    
    Specified by:
    
    stopBroadcasting in interface WOWZBroadcastAPI.Broadcaster
    
    Returns:
    
    The status after transitioning each broadcast component to WOWZState.IDLE.
  - changeAdaptiveBitrate
```
public void changeAdaptiveBitrate(int bitrate)
```
    Specified by:
    
    changeAdaptiveBitrate in interface WOWZBroadcastAPI.AdaptiveBroadcaster
  - getAdaptiveBitrate
```
public int getAdaptiveBitrate()
```
    Specified by:
    
    getAdaptiveBitrate in interface WOWZBroadcastAPI.AdaptiveBroadcaster
  - changeAdaptiveFramerate
```
public void changeAdaptiveFramerate(int framerate)
```
    Specified by:
    
    changeAdaptiveFramerate in interface WOWZBroadcastAPI.AdaptiveBroadcaster
  - getAdaptiveFramerate
```
public int getAdaptiveFramerate()
```
    Specified by:
    
    getAdaptiveFramerate in interface WOWZBroadcastAPI.AdaptiveBroadcaster
  - startPreview
```
public WOWZCamera startPreview(WOWZMediaConfig cameraConfig,
                               WOWZCameraView.PreviewStatusListener previewStatusListener)
```
    Starts the camera preview display.
    
    Returns:
    
    The active camera being displayed.
  - startPreview
```
public WOWZCamera startPreview(WOWZCameraView.PreviewStatusListener previewStatusListener)
```
  - startPreview
```
public WOWZCamera startPreview(WOWZMediaConfig cameraConfig)
```
    Starts the camera preview display using the values from the specified configuration for the camera frame size and frame rate.
    
    Parameters:
    
    cameraConfig - A configuration with the frame size and frame rate to use.
  - startPreview
```
public WOWZCamera startPreview()
```
    Starts the camera preview display.
    
    Returns:
    
    The active camera being displayed.
  - stopPreview
```
public WOWZCamera stopPreview(WOWZCameraView.PreviewStatusListener previewStatusListener)
```
    Stops the camera preview display.
  - stopPreview
```
public WOWZCamera stopPreview()
```
    Stops the camera preview display.
  - clearView
```
public void clearView()
```
    Clears the currently rendered frame from the view.
  - setSurfaceExtension
```
public void setSurfaceExtension(int extensionType)
```
  - setCameraConfig
```
public void setCameraConfig(WOWZMediaConfig previewConfig)
```
    Updates the frame size and frame rate for the active camera with the corresponding values from the specified configuration.
    
    Parameters:
    
    previewConfig - A configuration with the frame size and frame rate values to use.
  - getScaleMode
```
public int getScaleMode()
```
  - setScaleMode
```
public void setScaleMode(int scaleMode)
```
  - getFrameSize
```
public WOWZSize getFrameSize()
```
    Gets the currently configured video frame size.
    
    Returns:
    
    The current frame size.
  - getActiveFrameSize
```
public WOWZSize getActiveFrameSize()
```
    Gets the active video frame size, which may differ from the requested frame size if the current scale mode is FILL_VIEW.
    
    Returns:
    
    The active video frame size.
  - setFrameSize
```
public WOWZSize setFrameSize(int width,
                             int height)
```
    Updates the frame size for the active camera with the specified values. The actual frame size resulting from this operation may differ from the specified frame size. If the active camera device doesn't support the specified frame size, the closest, larger frame size that is supported will be used instead and indicated as the return value from this method.
    
    Parameters:
    
    width - The width of the video frame size, in pixels.
    
    height - The height of the video frame size, in pixels.
    
    Returns:
    
    The actual frame size used, which may differ from the specified frame size depending on device support.
  - setFrameSize
```
public WOWZSize setFrameSize(WOWZSize frameSize)
```
    Updates the frame size for the active camera with the specified size. The actual frame size resulting from this operation may differ from the specified frame size. If the active camera device doesn't support the specified frame size, the closest, larger frame size that is supported will be used instead and indicated as the return value from this method.
    
    Parameters:
    
    frameSize - The frame size specification.
    
    Returns:
    
    The actual frame size used, which may differ from the specified frame size depending on device support.
  - getFramerate
```
public int getFramerate()
```
    Gets the currently configured video frame rate.
    
    Returns:
    
    The current frame rate.
  - setFramerate
```
public int setFramerate(int framerate)
```
    Updates the frame rate for the active camera with the specified value. The actual frame rate resulting from this call may differ from the specified frame rate. If the active camera device doesn't support the specified frame rate, the closest supported frame rate will be used instead and indicated as the return value from this method.
    
    Parameters:
    
    framerate - The requested frame rate, in fps.
    
    Returns:
    
    The actual frame rate, which may differ from the specified value depending on device support.
  - getCameras
```
public WOWZCamera[] getCameras()
```
    Gets an array of WOWZCamera instances for each camera device present.
    
    Returns:
    
    An array of camera instances.
  - getCamera
```
public WOWZCamera getCamera()
```
    Gets the active camera.
    
    Returns:
    
    The active camera, or null is no camera is active.
  - getCameraById
```
public WOWZCamera getCameraById(int cameraId)
```
    Gets a camera instance based on its ID specifier.
    
    Parameters:
    
    cameraId - The camera's unique ID available via WOWZCamera.getCameraId().
    
    Returns:
    
    The corresponding camera instance, or null if the specified camera isn't present.
  - getCameraByDirection
```
public WOWZCamera getCameraByDirection(int direction)
```
    Gets a camera instance based on its ID specifier
    
    Parameters:
    
    direction - WOWZCamera.DIRECTION_FRONT or WOWZCamera##DIRECTION_FRONT.
    
    Returns:
    
    The corresponding camera instance, or null if the specified camera isn't present.
  - getOtherCamera
```
public WOWZCamera getOtherCamera()
```
    Gets the camera that isn't currently active, if present.
    
    Returns:
    
    The inactive camera, or null if another camera isn't present.
  - getOtherCameraId
```
public int getOtherCameraId()
```
    Gets the ID of the camera that isn't currently active, if present.
    
    Returns:
    
    The ID of the inactive camera, or null if another camera isn't present.
  - setCamera
```
public WOWZCamera setCamera(int cameraId)
```
    Sets the active camera.
    
    Parameters:
    
    cameraId - The ID of the camera to display.
    
    Returns:
    
    The corresponding camera instance, or null if the specified camera isn't present.
  - setCamera
```
public WOWZCamera setCamera(WOWZCamera camera)
```
    Sets the active camera.
    
    Parameters:
    
    camera - The camera to display.
    
    Returns:
    
    The corresponding camera instance, or null if the specified camera isn't present.
  - setCameraByDirection
```
public WOWZCamera setCameraByDirection(int direction)
```
    Sets the active camera based on the specified direction (front or back).
    
    Parameters:
    
    direction - WOWZCamera.DIRECTION_FRONT or WOWZCamera##DIRECTION_FRONT.
    
    Returns:
    
    The corresponding camera instance. or null if the specified camera isn't present.
  - switchCamera
```
public WOWZCamera switchCamera()
```
    Changes the active camera being previewed to the alternate device camera, if available. In order to switch the active camera while streaming, the alternate camera must support the video frame size of the currently active camera.
  - isSwitchCameraAvailable
```
public boolean isSwitchCameraAvailable(WOWZSize withFrameSize)
```
    Checks whether the current camera can be switched based on the state of any live streaming broadcast currently active and device presence. In order to switch the active camera while streaming, the other camera must support the video frame size of the currently active camera.
    
    Parameters:
    
    withFrameSize - If supplied, the result will only be true if the other camera supports the specified frame size.
    
    Returns:
    
    True if the active camera can be switched; false otherwise.
  - isSwitchCameraAvailable
```
public boolean isSwitchCameraAvailable(WOWZMediaConfig mediaConfig)
```
    Checks whether the current camera can be switched based on the state of any live streaming broadcast currently active and device presence. In order to switch the active camera while streaming, the other camera must support the frane size of the currently active camera.
    
    Parameters:
    
    mediaConfig - If supplied, the result will only be true if the other camera supports the video frame size indicated by the specified configration.
    
    Returns:
    
    True if the active camera can be switched; false otherwise.
  - isSwitchCameraAvailable
```
public boolean isSwitchCameraAvailable()
```
    Checks whether the current camera can be switched based on the state of any live streaming broadcast currently active and device presence. In order to switch the active camera while streaming, the other camera must support the video frame size of the currently active camera.
    
    Returns:
    
    True if the active camera can be switched; false otherwise.
  - doConfigChange
```
public void doConfigChange()
```
  - onConfigurationChanged
```
public void onConfigurationChanged(Configuration newConfig)
```
    Called when the device configuration changes, typically to detect device orientation changes.
    
    Parameters:
    
    newConfig - The new device configuration. https://developer.android.com/reference/android/app/Activity.html#ConfigurationChanges
  - onLowMemory
```
public void onLowMemory()
```
    Called when the overall system is running low on memory and actively running processes should trim their memory usage. https://developer.android.com/reference/android/app/Activity.html#onLowMemory()
  - surfaceCreated
```
public void surfaceCreated(SurfaceHolder surfaceHolder)
```
    Called immediately after the surface is first created. Implementations of this should start up whatever rendering code they desire. Only one thread can ever draw into a Surface, so you should not draw into the Surface here if your normal rendering will be in another thread.
    
    Parameters:
    
    surfaceHolder - The SurfaceHolder whose surface is being created.
  - surfaceChanged
```
public void surfaceChanged(SurfaceHolder holder,
                           int format,
                           int width,
                           int height)
```
    Called immediately after any structural changes (format or size) have been made to the surface. You should at this point update the imagery in the surface. This method is always called at least once, after surfaceCreated(SurfaceHolder).
    
    Parameters:
    
    holder - The SurfaceHolder whose surface has changed.
  - surfaceDestroyed
```
public void surfaceDestroyed(SurfaceHolder holder)
```
    Called immediately before a surface is being destroyed. After returning from this call, you should no longer try to access this surface. If you have a rendering thread that directly accesses the surface, you must ensure that thread is no longer touching the Surface before returning from this function.
    
    Parameters:
    
    holder - The SurfaceHolder whose surface is being destroyed.
  - onPause
```
public void onPause()
```
    Called from the activity's onPause() method to store the state of the camera preview display before the application is sent to the background. The stored state can then be restored with a corresponding call to onResume() made from the activity's onResume() method.
  - onResume
```
public void onResume()
```
    Use in conjunction with onPause() when called from the activity's onResume() method to restart the camera preview display based on the state it was in when the activity was paused and a corresponding call to onPause() was made.
  - getScreenSize
```
public WOWZSize getScreenSize()
```
    Gets the size of camera preview display.
    
    Returns:
    
    The size of camera preview display, in pixels.
  - registerFrameRenderer
```
public void registerFrameRenderer(WOWZRenderAPI.VideoFrameRenderer frameRenderer)
```
    Registers an object instance implementing the WOWZRenderAPI.VideoFrameRenderer interface that can be used to render additional content, such as a logo, to the camera preview display.
    
    Parameters:
    
    frameRenderer - An instance of a WOWZRenderAPI.VideoFrameRenderer implementation.
  - unregisterFrameRenderer
```
public void unregisterFrameRenderer(WOWZRenderAPI.VideoFrameRenderer frameRenderer)
```
    Unregisters a frame listener.
    
    Parameters:
    
    frameRenderer - A previously registered instance of a WOWZRenderAPI.VideoFrameRenderer implementation.
  - registerFrameListener
```
public void registerFrameListener(WOWZRenderAPI.VideoFrameListener frameListener)
```
    Registers an object instance implementing the WOWZRenderAPI.VideoFrameListener interface that can be used to capture content from the camera preview display.
    
    Parameters:
    
    frameListener - An instance of a WOWZRenderAPI.VideoFrameListener implementation.
  - unregisterFrameListener
```
public void unregisterFrameListener(WOWZRenderAPI.VideoFrameListener frameListener)
```
    Unregisters a frame listener.
    
    Parameters:
    
    frameListener - A previously registered instance of a WOWZRenderAPI.VideoFrameListener implementation.

Class WOWZCameraView

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EXTENSION_DEFAULT

EXTENSION_MIRROR

EXTENSION_BLACK_AND_WHITE

Constructor Detail

WOWZCameraView

WOWZCameraView

Method Detail

getNumberOfDeviceCameras

getDeviceCameras

getAvailableDeviceCameras

getCameraInfo

getDeviceOrientation

setPreviewStatusListener

setPreviewReadyListener

getPreviewStatus

getStatus

isPreviewing

isPreviewReady

isPreviewPaused

isPaused

getBroadcaster

getVideoBackgroundColor

setVideoBackgroundColor

getVideoSourceConfig

setVideoEnabled

isVideoEnabled

setVideoPaused

isVideoPaused

getBroadcastConfig

getBroadcasterStatus

prepareForBroadcast

startBroadcasting

stopBroadcasting

changeAdaptiveBitrate

getAdaptiveBitrate

changeAdaptiveFramerate

getAdaptiveFramerate

startPreview

startPreview

startPreview

startPreview

stopPreview

stopPreview

clearView

setSurfaceExtension

setCameraConfig

getScaleMode

setScaleMode

getFrameSize

getActiveFrameSize

setFrameSize

setFrameSize

getFramerate

setFramerate

getCameras

getCamera

getCameraById

getCameraByDirection

getOtherCamera

getOtherCameraId

setCamera

setCamera

setCameraByDirection

switchCamera

isSwitchCameraAvailable

isSwitchCameraAvailable

isSwitchCameraAvailable

doConfigChange

onConfigurationChanged

onLowMemory

surfaceCreated

surfaceChanged

surfaceDestroyed