# 白平衡设置(ArkTS)

从API version 20开始，支持设置白平衡效果。白平衡是相机的色彩校正技术，通过设置白平衡，使照片产生不同的效果。目前白平衡效果支持：拍照（PhotoSession）、录像（VideoSession）和安全相机模式（SecureSession）。

#### 开发步骤

详细的API说明请参考Camera。

1.  导入camera接口，接口中提供相机相关的属性和方法。
    
    ```
    import { camera } from '@kit.CameraKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    ```
    
2.  白平衡的设置提供两种方法。
    
    *   方法一：通过isWhiteBalanceModeSupported判断是否支持该白平衡模式。再通过setWhiteBalanceMode和getWhiteBalanceMode分别设置和查看白平衡模式（只能查看当前已设置的白平衡模式）。该接口提供白平衡模式设置，目前包括：自动，手动，阴天、白炽光、荧光和日光。当同时设置白平衡模式和设置白平衡值时，仅可生效一种，默认白平衡模式优先生效。
        
        ```
        function isWhiteBalanceModeSupported(session: camera.PhotoSession | camera.VideoSession): boolean {
           let status: boolean = false;
           let whiteBalanceMode: camera.WhiteBalanceMode | undefined = undefined;
           try {
              let mode: camera.WhiteBalanceMode = camera.WhiteBalanceMode.DAYLIGHT;
              status = session.isWhiteBalanceModeSupported(mode);
              if(status){
                 session.setWhiteBalanceMode(mode);
              }
              whiteBalanceMode = session.getWhiteBalanceMode();
           } catch (error) {
              let err = error as BusinessError;
              console.error(`The isWhiteBalanceModeSupported call failed. error code: ${err.code}`);
           }
           return status;
        }
        ```
        
    *   方法二：通过getWhiteBalanceRange接口，获取当前设备支持的白平衡值范围。再通过setWhiteBalance和getWhiteBalance分别设置和查看白平衡值（只能查看当前已设置的白平衡值）。
        
        ```
        function getWhiteBalanceRange(session: camera.PhotoSession | camera.VideoSession): Array<number> {
           let range: Array<number> = [];
           try {
              range = session.getWhiteBalanceRange();
              let whiteBalance: number = 3000;
              if(whiteBalance >= range[0] && whiteBalance <= range[1]) {
                 session.setWhiteBalance(whiteBalance);
              }
              whiteBalance = session.getWhiteBalance();
           } catch (error) {
             let err = error as BusinessError;
             console.error(`The getWhiteBalanceRange call failed. error code: ${err.code}`);
           }
           return range;
        }
        ```