RCRTCCameraOutputStream (release 5.1.16)

所有超级接口:

RCRTCOutputStream, RCRTCStream, RCRTCVideoOutputStream, RCRTCVideoStream<RCRTCVideoOutputStreamEventListener>
```
public interface RCRTCCameraOutputStream
extends RCRTCVideoOutputStream
```

嵌套类概要
- 从接口继承的嵌套类/接口 cn.rongcloud.rtc.base.RCRTCStream
  RCRTCStream.RCRTCType

字段概要
- 从接口继承的字段 cn.rongcloud.rtc.base.RCRTCStream
  RONG_TAG, TAG_CDN, TAG_DEFAULT, TAG_MCU_LIVE, TAG_SCREEN_SHARE

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`boolean`	`enableCameraTorch(boolean enable)` 设置是否打开闪光灯注意：该方法必须在打开相机后调用，可以通过 `startCamera(IRCRTCResultDataCallback)` 或 `startCamera(int, boolean, IRCRTCResultDataCallback)` 方法打开相机
`void`	`enableTinyStream(boolean enable)` 是否开启大小流
`float`	`getCameraMaxZoomFactor()` 获取摄像头支持最大缩放比例。
`RCRTCVideoStreamConfig`	`getTinyVideoConfig()` 获取小流配置
`boolean`	`isCameraExposurePositionSupported()` 摄像头是否支持区域测光
`boolean`	`isCameraFocusSupported()` 摄像头是否支持区域对焦
`boolean`	`isCameraTorchSupported()` 检测设备是否支持闪光灯常开注意：该方法必须在打开相机后调用，可以通过 `startCamera(IRCRTCResultDataCallback)` 或 `startCamera(int, boolean, IRCRTCResultDataCallback)` 方法打开相机
`boolean`	`isCameraZoomSupported()` 检测设备是否支持摄像头缩放功能注意：该方法必须在打开相机后调用，可以通过 `startCamera(IRCRTCResultDataCallback)` 或 `startCamera(int, boolean, IRCRTCResultDataCallback)` 方法打开相机
`boolean`	`isEncoderMirror()` 获取视频编码镜像状态
`boolean`	`isFrontCamera()` 当前开启是否为前置摄像头
`boolean`	`isPreviewMirror()` 获取本地镜像预览状态
`void`	`setCameraDisplayOrientation(int orientation)` 设置摄像头采集角度为 0 时使用 SDK 中获取的摄像头 id 计算出的采集角度，当开启是手机前置摄像头时，设置该参数会顺时针旋转图像，
`boolean`	`setCameraExposurePositionInPreview(float x, float y)` 在指定点区域测光
`boolean`	`setCameraFocusPositionInPreview(float x, float y)` 在指定点区域对焦
`boolean`	`setCameraZoomFactor(float zoomFactor)` 设置摄像头缩放比例注意：该方法必须在打开相机后调用，可以通过 `startCamera(IRCRTCResultDataCallback)` 或 `startCamera(int, boolean, IRCRTCResultDataCallback)` 方法打开相机
`boolean`	`setCustomizedCameraParameter(Map<String,String> parameter)` 设置自定义的相机参数注意：该方法必须在打开相机后调用，可以通过 `startCamera(IRCRTCResultDataCallback)` 或 `startCamera(int, boolean, IRCRTCResultDataCallback)` 方法打开相机
`void`	`setEncoderMirror(boolean mirror)` 设置视频编码是否镜像默认关闭
`void`	`setFrameOrientation(int orientation)` 视频编码的旋转角度设置为 -1 时将跟随系统角度，当开启是手机前置摄像头时，设置该参数会逆时针旋转图像
`void`	`setPreviewMirror(boolean mirror)` 设置本地镜像预览状态默认开启
`boolean`	`setTinyVideoConfig(RCRTCVideoStreamConfig config)` 设置小流参数配置
`void`	`setVideoConfig(RCRTCVideoStreamConfig config)` 设置视频分辨率、码率、帧率。
`void`	`startCamera(int cameraId, boolean mirror, IRCRTCResultDataCallback<Boolean> cameraCallback)` 开启指定摄像头数据采集
`void`	`startCamera(IRCRTCResultDataCallback<Boolean> cameraCallback)` 开启摄像头数据采集切换摄像头请调用 `switchCamera(CameraVideoCapturer.CameraSwitchHandler)`
`void`	`stopCamera()` 停止摄像头数据采集此方法在`RCRTCEngine.joinRoom(String, IRCRTCResultDataCallback< RCRTCRoom >)` 执行之后调用才会生效停用摄像头，此方法配合`stopCamera()`}对应使用，当聊天页面被切换到后台时，可以调用此方法来释放相机资源，以确保其他用到相机的App能正常使用相机
`void`	`stopCamera(IRCRTCResultCallback cameraCallback)` 停止摄像头数据采集此方法在`RCRTCEngine.joinRoom(String, IRCRTCResultDataCallback< RCRTCRoom >)` 执行之后调用才会生效停用摄像头，此方法配合`stopCamera()`}对应使用，当聊天页面被切换到后台时，可以调用此方法来释放相机资源，以确保其他用到相机的App能正常使用相机
`void`	`switchCamera(CameraVideoCapturer.CameraSwitchHandler handler)` 切换前后摄像头
`void`	`switchCamera(int cameraId, boolean mirror, CameraVideoCapturer.CameraSwitchHandler handler)` 切换至指定摄像头

从接口继承的方法 cn.rongcloud.rtc.api.stream.RCRTCVideoOutputStream
getTextureHelper, getVideoConfig, setSource, setVideoFrameListener, setWatermark

从接口继承的方法 cn.rongcloud.rtc.api.RCRTCVideoStream
getStreamEventListener, getTextureView, getVideoView, setStreamEventListener, setTextureView, setVideoView

从接口继承的方法 cn.rongcloud.rtc.base.RCRTCStream
getMediaType, getResourceState, getStreamId, getTag, getType, getUserId, isMute, mute

- 方法详细资料
  - startCamera
```
void startCamera(IRCRTCResultDataCallback<Boolean> cameraCallback)
```
    开启摄像头数据采集
    切换摄像头请调用 switchCamera(CameraVideoCapturer.CameraSwitchHandler)
  - startCamera
```
void startCamera(int cameraId,
                 boolean mirror,
                 IRCRTCResultDataCallback<Boolean> cameraCallback)
```
    开启指定摄像头数据采集
    参数:
    
    cameraId -
    mirror - 是否镜像视频流
    该参数设置仅对本地有效(发送出去的数据依然是未处理数据),如果本地视频流做了镜像处理，为了对端观看体验可以添加如下设置：
    
    RongRTCVideoView remoteView = RongRTCEngine.getInstance().createVideoView(CallActivity.this.getApplicationContext()); remoteView.setMirror(boolean);
    某些特殊设备将后置摄像头安装在设备的前面时，当打开后置摄像头时为了正常显示，请使用镜像处理；
    cameraCallback -
  - switchCamera
```
void switchCamera(CameraVideoCapturer.CameraSwitchHandler handler)
```
    切换前后摄像头
    
    参数:
    
    handler -
  - switchCamera
```
void switchCamera(int cameraId,
                  boolean mirror,
                  CameraVideoCapturer.CameraSwitchHandler handler)
```
    切换至指定摄像头
    参数:
    
    cameraId -
    mirror - 是否镜像视频流
    该参数设置仅对本地有效(发送出去的数据依然是未处理数据),如果本地视频流做了镜像处理，为了对端观看体验可以添加如下设置：
    
    RongRTCVideoView remoteView = RongRTCEngine.getInstance().createVideoView(CallActivity.this.getApplicationContext()); remoteView.setMirror(boolean);
    某些特殊设备将后置摄像头安装在设备的前面时，当打开后置摄像头时为了正常显示，请使用镜像处理；
    handler -
  - stopCamera
```
void stopCamera()
```
    停止摄像头数据采集
    此方法在RCRTCEngine.joinRoom(String, IRCRTCResultDataCallback< RCRTCRoom >) 执行之后调用才会生效
    停用摄像头，此方法配合stopCamera()}对应使用，当聊天页面被切换到后台时，
    可以调用此方法来释放相机资源，以确保其他用到相机的App能正常使用相机
  - stopCamera
```
void stopCamera(IRCRTCResultCallback cameraCallback)
```
    停止摄像头数据采集
    此方法在RCRTCEngine.joinRoom(String, IRCRTCResultDataCallback< RCRTCRoom >) 执行之后调用才会生效
    停用摄像头，此方法配合stopCamera()}对应使用，当聊天页面被切换到后台时，
    可以调用此方法来释放相机资源，以确保其他用到相机的App能正常使用相机
    
    参数:
    
    cameraCallback - 结果回调
  - setVideoConfig
```
void setVideoConfig(RCRTCVideoStreamConfig config)
```
    设置视频分辨率、码率、帧率。此方法支持通话过程中动态设置。
    
    指定者:
    
    setVideoConfig 在接口中 RCRTCVideoOutputStream
    
    参数:
    
    config - 配置信息
  - setCameraDisplayOrientation
```
void setCameraDisplayOrientation(int orientation)
```
    设置摄像头采集角度
    为 0 时使用 SDK 中获取的摄像头 id 计算出的采集角度，当开启是手机前置摄像头时，设置该参数会顺时针旋转图像，
    
    参数:
    
    orientation - 默认为 0 则使用 SDK 中获取的摄像头 id 计算出的采集角度，值必须设置为：0、90、180、270
  - setFrameOrientation
```
void setFrameOrientation(int orientation)
```
    视频编码的旋转角度
    设置为 -1 时将跟随系统角度，当开启是手机前置摄像头时，设置该参数会逆时针旋转图像
    
    参数:
    
    orientation - 默认：-1，设置为 -1 时将跟随系统角度，值必须设置为：0、90、180、270
  - setPreviewMirror
```
void setPreviewMirror(boolean mirror)
```
    设置本地镜像预览状态默认开启
    
    参数:
    
    mirror - true: 开启镜像 false: 不开启
  - setEncoderMirror
```
void setEncoderMirror(boolean mirror)
```
    设置视频编码是否镜像默认关闭
    
    参数:
    
    mirror - true: 开启镜像 false: 不开启
  - isPreviewMirror
```
boolean isPreviewMirror()
```
    获取本地镜像预览状态
    
    返回:
  - isEncoderMirror
```
boolean isEncoderMirror()
```
    获取视频编码镜像状态
    
    返回:
  - isFrontCamera
```
boolean isFrontCamera()
```
    当前开启是否为前置摄像头
    
    返回:
  - enableTinyStream
```
void enableTinyStream(boolean enable)
```
    是否开启大小流
  - setTinyVideoConfig
```
boolean setTinyVideoConfig(RCRTCVideoStreamConfig config)
```
    设置小流参数配置
    
    参数:
    
    config -
    
    返回:
  - getTinyVideoConfig
```
RCRTCVideoStreamConfig getTinyVideoConfig()
```
    获取小流配置
    
    返回:
  - isCameraFocusSupported
```
boolean isCameraFocusSupported()
```
    摄像头是否支持区域对焦
    
    返回:
    
    若支持则返回 true，否则返回 false
  - isCameraExposurePositionSupported
```
boolean isCameraExposurePositionSupported()
```
    摄像头是否支持区域测光
    
    返回:
    
    若支持则返回 true，否则返回 false
  - setCameraExposurePositionInPreview
```
boolean setCameraExposurePositionInPreview(float x,
                                           float y)
```
    在指定点区域测光
    
    参数:
    
    x - 视图中焦点的 x 轴坐标
    
    y - 视图中焦点的 y 轴坐标
    
    返回:
    
    若设置成功返回 true，否则返回 false
  - setCameraFocusPositionInPreview
```
boolean setCameraFocusPositionInPreview(float x,
                                        float y)
```
    在指定点区域对焦
    
    参数:
    
    x - 视图中焦点的 x 轴坐标
    
    y - 视图中焦点的 y 轴坐标
    
    返回:
    
    若设置成功返回 true，否则返回 false
  - isCameraTorchSupported
```
boolean isCameraTorchSupported()
```
    检测设备是否支持闪光灯常开
    注意：该方法必须在打开相机后调用，可以通过 startCamera(IRCRTCResultDataCallback) 或 startCamera(int, boolean, IRCRTCResultDataCallback) 方法打开相机
    
    返回:
    
    true：设备支持闪光灯常开 false：设备不支持闪光灯常开
  - enableCameraTorch
```
boolean enableCameraTorch(boolean enable)
```
    设置是否打开闪光灯
    注意：该方法必须在打开相机后调用，可以通过 startCamera(IRCRTCResultDataCallback) 或 startCamera(int, boolean, IRCRTCResultDataCallback) 方法打开相机
    
    参数:
    
    enable - true：打开 false：关闭
    
    返回:
    
    true：设置成功， false: 设置失败
  - isCameraZoomSupported
```
boolean isCameraZoomSupported()
```
    检测设备是否支持摄像头缩放功能
    注意：该方法必须在打开相机后调用，可以通过 startCamera(IRCRTCResultDataCallback) 或 startCamera(int, boolean, IRCRTCResultDataCallback) 方法打开相机
    
    返回:
    
    true：设备支持相机缩放功能 false：设备不支持相机缩放功能
  - setCameraZoomFactor
```
boolean setCameraZoomFactor(float zoomFactor)
```
    设置摄像头缩放比例
    注意：该方法必须在打开相机后调用，可以通过 startCamera(IRCRTCResultDataCallback) 或 startCamera(int, boolean, IRCRTCResultDataCallback) 方法打开相机
    
    参数:
    
    zoomFactor - 相机缩放比例，有效范围从 1.0 到最大缩放 getCameraMaxZoomFactor()
    
    返回:
    
    true: 设置成功 false: 设置失败
  - getCameraMaxZoomFactor
```
float getCameraMaxZoomFactor()
```
    获取摄像头支持最大缩放比例。
    注意：该方法必须在打开相机后调用，可以通过 startCamera(IRCRTCResultDataCallback) 或 startCamera(int, boolean, IRCRTCResultDataCallback) 方法打开相机
    
    返回:
    
    该相机支持的最大缩放比例
  - setCustomizedCameraParameter
```
boolean setCustomizedCameraParameter(Map<String,String> parameter)
```
    设置自定义的相机参数
    注意：该方法必须在打开相机后调用，可以通过 startCamera(IRCRTCResultDataCallback) 或 startCamera(int, boolean, IRCRTCResultDataCallback) 方法打开相机
    
    参数:
    
    parameter - Camera.Parameters
    
    返回:
    
    true: 设置成功 false: 设置失败

接口 RCRTCCameraOutputStream

嵌套类概要

从接口继承的嵌套类/接口 cn.rongcloud.rtc.base.RCRTCStream

字段概要

从接口继承的字段 cn.rongcloud.rtc.base.RCRTCStream

方法概要

从接口继承的方法 cn.rongcloud.rtc.api.stream.RCRTCVideoOutputStream

从接口继承的方法 cn.rongcloud.rtc.api.RCRTCVideoStream

从接口继承的方法 cn.rongcloud.rtc.base.RCRTCStream

方法详细资料

startCamera

startCamera

switchCamera

switchCamera

stopCamera

stopCamera

setVideoConfig

setCameraDisplayOrientation

setFrameOrientation

setPreviewMirror

setEncoderMirror

isPreviewMirror

isEncoderMirror

isFrontCamera

enableTinyStream

setTinyVideoConfig

getTinyVideoConfig

isCameraFocusSupported

isCameraExposurePositionSupported

setCameraExposurePositionInPreview

setCameraFocusPositionInPreview

isCameraTorchSupported

enableCameraTorch

isCameraZoomSupported

setCameraZoomFactor

getCameraMaxZoomFactor

setCustomizedCameraParameter