AVChatCameraCapturer.java

浏览该文件的文档.

/*
 * Copyright (c) 2014-2018 NetEase, Inc.
 * All right reserved.
 */

package com.netease.nimlib.sdk.avchat.video;

import android.hardware.Camera;

import com.netease.nimlib.sdk.avchat.AVChatStateObserver;
import com.netease.nimlib.sdk.avchat.constant.AVChatDeviceEvent;
import com.netease.nimlib.sdk.avchat.video.AVChatVideoCapturer;
import com.netease.nimlib.sdk.avchat.video.AVChatVideoCapturerFactory;

/**
 * 提供一些操作相机的接口
 * <p>通过{@link AVChatVideoCapturerFactory#createCameraPolicyCapturer(boolean)} 创建
 */

public abstract class AVChatCameraCapturer implements AVChatVideoCapturer {

    /**
     * 设置缩放
     * @param zoomValue 缩放参数
     */
    public abstract void setZoom(int zoomValue);

    /**
     * 获取当前缩放比例
     * @return 获取当前缩放比例
     */
    public abstract int getCurrentZoom();

    /**
     *  获取摄像头支持的最大视频缩放比例
     *  @return 摄像头支持的最大视频缩放比例
     */
    public abstract int getMaxZoom();

    /**
     * 开启或关闭闪光灯
     * @param flash true:开启 false:关闭
     * @return 0:成功  1: 失败  2:不支持
     */
    public abstract int setFlash(boolean flash);

    /**
     * 切换摄像头
     * @return 0:请求成功, 其他失败<br>
     * 切换成功会回调 {@link AVChatStateObserver#onDeviceEvent(int, String)}
     * @see AVChatDeviceEvent#VIDEO_CAMERA_SWITCH_OK
     * @see AVChatDeviceEvent#VIDEO_CAMERA_SWITCH_ERROR
     */
    public abstract int switchCamera();

    /**
     * 是否拥有多个摄像头.
     *
     * @return <{@code true} 拥有多个摄像头. {@code false} 不具有多个摄像头.
     */
    public static boolean hasMultipleCameras(){
        return Camera.getNumberOfCameras() > 1;
    }

    /**
     * 设置测光区域
     * @param x 测光区域x坐标
     * @param y 测光区域y坐标
     */
    public abstract void setMeteringAreas(float x, float y);

    /**
     * 设置对焦区域
     * @param x 对焦区域x坐标
     * @param y 对焦区域y坐标
     */
    public abstract void setFocusAreas(float x, float y);
}