Package com.zego.zegoavkit2.camera

Class ZegoCamera

  • public class ZegoCamera
extends java.lang.Object
    自定义相机类。

    Copyright © 2017 Zego. All rights reserved.

    • Constructor Detail

      • ZegoCamera

        public ZegoCamera()

    • Method Detail

      • setCamFocusPoint

        @Deprecated
public static boolean setCamFocusPoint​(float fx,
                                       float fy,
                                       int channelIndex)
        Deprecated.
        用 setCamFocusPointInPreview(float, float, int) 代替
        设置对焦位置。

        注意： 1. 必须在 InitSDK 之后调用;
        2. Point坐标x,y取值范围为从0到1，[0,0]为左上角，[1,1]为右下角；
        3. 必须先设置 setCamFocusPoint(float, float, int) 再设置 setCamFocusMode(ZegoCameraFocusMode, int) ，自定义对焦才能生效。

        Parameters:
        fx - 对焦位置横坐标
        fy - 对焦位置纵坐标
        channelIndex - 推流 channel Index，参考 com.zego.zegoavkit2.ZegoConstants.PublishChannelIndex
        Returns:
        true 成功，false 失败

      • setCamExposureMode

        public static boolean setCamExposureMode​(ZegoCameraExposureMode mode,
                                         int channelIndex)
        设置曝光模式。

        注意： 1. 必须在 InitSDK 之后调用;
        2. 若需要恢复到原始曝光模式，则将曝光模式设置为 ZegoCameraExposureMode.AUTO ,或等 UnInitSDK 后引擎自动清理。

        Parameters:
        mode - 曝光模式，参考 ZegoCameraExposureMode
        channelIndex - 推流 channel Index，参考 com.zego.zegoavkit2.ZegoConstants.PublishChannelIndex
        Returns:
        true 成功，false 失败

      • setCamExposureCompensation

        public static boolean setCamExposureCompensation​(float value,
                                                 int channelIndex)
        设置曝光补偿度。

        注意： 1. 必须在 InitSDK 之后调用;
        2. 只有设置了曝光模式为 ZegoCameraExposureMode.CUSTOM ，自定义曝光才能生效;
        3. 若需要恢复到原始曝光模式，则将曝光模式设置为 ZegoCameraExposureMode.AUTO ,或等 UnInitSDK 后引擎自动清理。

        Parameters:
        value - 曝光补偿度，取值范围为[-1,1]
        channelIndex - 推流 channel Index，参考 com.zego.zegoavkit2.ZegoConstants.PublishChannelIndex
        Returns:
        true 成功，false 失败

      • setCamExposurePoint

        @Deprecated
public static boolean setCamExposurePoint​(float x,
                                          float y,
                                          int channelIndex)
        Deprecated.
        用 setCamExposurePointInPreview(float, float, int) 代替
        设置曝光点。

        注意： 1. 必须在初始化 SDK 后调用；
        2. 屏幕左上角坐标为 (0.0, 0.0)，右下角坐标为（1.0，1.0）

        Parameters:
        x - ，取值范围 [0.0, 1.0]
        y - ，取值范围 [0.0, 1.0]
        channelIndex - 推流 channel Index，参考 com.zego.zegoavkit2.ZegoConstants.PublishChannelIndex
        Returns:
        true 成功，false 失败

      • setCamFocusPointInPreview

        public static boolean setCamFocusPointInPreview​(float x,
                                                float y,
                                                int channelIndex)
        设置预览视图中的对焦点

        注意： 1. 每次摄像头重新启动采集，设置都会失效，需要重新设置
        2. 预览视图的左上角坐标为 (0.0, 0.0)，右下角坐标为（1.0，1.0）
        3. 如果要使用对焦功能最好关闭人脸识别，目前iOS和Android是默认开启的, 通过SetConfig("camera_detect_face=false")关闭

        Parameters:
        x - ，取值范围 [0.0, 1.0]
        y - ，取值范围 [0.0, 1.0]
        channelIndex - 推流 channel Index，参考 com.zego.zegoavkit2.ZegoConstants.PublishChannelIndex
        Returns:
        true 成功，false 失败

      • setCamExposurePointInPreview

        public static boolean setCamExposurePointInPreview​(float x,
                                                   float y,
                                                   int channelIndex)
        设置预览视图中的曝光参考点

        注意： 1. 每次摄像头重新启动采集，设置都会失效，需要重新设置
        2. 预览视图的左上角坐标为 (0.0, 0.0)，右下角坐标为（1.0，1.0）

        Parameters:
        x - ，取值范围 [0.0, 1.0]
        y - ，取值范围 [0.0, 1.0]
        channelIndex - 推流 channel Index，参考 com.zego.zegoavkit2.ZegoConstants.PublishChannelIndex
        Returns:
        true 成功，false 失败

      • setCamZoomFactor

        public static boolean setCamZoomFactor​(float zoomFactor,
                                       int channelIndex)
        设置摄像头变焦倍数

        注意： 1. 每次摄像头重新启动采集，设置都会失效，需要重新设置

        Parameters:
        zoomFactor - 变焦倍数，最小值为1.0，最大值不能超过 GetCamMaxZoomFactor 的返回值
        channelIndex - 推流 channel Index，参考 com.zego.zegoavkit2.ZegoConstants.PublishChannelIndex
        Returns:
        true 成功，false 失败

      • getCamMaxZoomFactor

        public static float getCamMaxZoomFactor​(int channelIndex)
        获取摄像头最大变焦倍数

        注意: 要摄像头启动成功,可以是采集首帧的时候，获取该值。

        Parameters:
        channelIndex - 推流 channel Index，参考 com.zego.zegoavkit2.ZegoConstants.PublishChannelIndex
        Returns:
        返回最大变焦倍数，1.0为不支持变焦

      • enableCamAdaptiveFPS

        public static void enableCamAdaptiveFPS​(boolean enable,
                                        int minFPS,
                                        int maxFPS,
                                        int channelIndex)
        开启摄像头自适应帧率
        Parameters:
        enable - true 开启，false 关闭
        minFPS - 期望帧率的最小值，最小值为 3，建议 15
        maxFPS - 期望帧率的最大值，非负值，建议 25
        index - 推流通道