AVChatParameters.java

浏览该文件的文档.

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

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

import android.view.Surface;

import com.netease.nimlib.sdk.avchat.AVChatCallback;
import com.netease.nimlib.sdk.avchat.AVChatManager;
import com.netease.nimlib.sdk.avchat.AVChatManagerLite;
import com.netease.nimlib.sdk.avchat.AVChatStateObserver;
import com.netease.nimlib.sdk.avchat.AVChatStateObserverLite;
import com.netease.nimlib.sdk.avchat.constant.AVChatAudioEffectMode;
import com.netease.nimlib.sdk.avchat.constant.AVChatAudioSampleRate;
import com.netease.nimlib.sdk.avchat.constant.AVChatMediaCodecMode;
import com.netease.nimlib.sdk.avchat.constant.AVChatServerRecordMode;
import com.netease.nimlib.sdk.avchat.constant.AVChatType;
import com.netease.nimlib.sdk.avchat.constant.AVChatUserRole;
import com.netease.nimlib.sdk.avchat.constant.AVChatVideoCaptureOrientation;
import com.netease.nimlib.sdk.avchat.constant.AVChatVideoCropRatio;
import com.netease.nimlib.sdk.avchat.constant.AVChatVideoFrameRate;
import com.netease.nimlib.sdk.avchat.constant.AVChatVideoQuality;
import com.netease.yunxin.base.annotation.IntDef;
import com.netease.yunxin.base.annotation.Runtime;
import com.netease.yunxin.base.annotation.StringDef;
import com.netease.yunxin.base.annotation.Writable;
import com.netease.nrtc.engine.rawapi.RtcKey;
import com.netease.nrtc.engine.rawapi.RtcParameters;
import com.netease.nrtc.sdk.common.VideoFilterParameter;
import com.netease.nrtc.sdk.video.VideoFrame;

import java.io.Serializable;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;

import static com.netease.nimlib.sdk.avchat.constant.AVChatAudioEffectMode.DISABLE;
import static com.netease.nimlib.sdk.avchat.constant.AVChatAudioEffectMode.PLATFORM_BUILTIN;
import static com.netease.nimlib.sdk.avchat.constant.AVChatAudioEffectMode.SDK_BUILTIN;
import static com.netease.nimlib.sdk.avchat.constant.AVChatMediaCodecMode.MEDIA_CODEC_AUTO;
import static com.netease.nimlib.sdk.avchat.constant.AVChatMediaCodecMode.MEDIA_CODEC_HARDWARE;
import static com.netease.nimlib.sdk.avchat.constant.AVChatMediaCodecMode.MEDIA_CODEC_SOFTWARE;
import static com.netease.nimlib.sdk.avchat.constant.AVChatServerRecordMode.MIX;
import static com.netease.nimlib.sdk.avchat.constant.AVChatServerRecordMode.MIX_AND_SINGLE;
import static com.netease.nimlib.sdk.avchat.constant.AVChatServerRecordMode.SINGLE;
import static com.netease.nimlib.sdk.avchat.constant.AVChatVideoFrameRate.FRAME_RATE_10;
import static com.netease.nimlib.sdk.avchat.constant.AVChatVideoFrameRate.FRAME_RATE_15;
import static com.netease.nimlib.sdk.avchat.constant.AVChatVideoFrameRate.FRAME_RATE_20;
import static com.netease.nimlib.sdk.avchat.constant.AVChatVideoFrameRate.FRAME_RATE_25;
import static com.netease.nimlib.sdk.avchat.constant.AVChatVideoFrameRate.FRAME_RATE_5;
import static com.netease.nimlib.sdk.avchat.model.AVChatImageFormat.I420;
import static com.netease.nimlib.sdk.avchat.model.AVChatImageFormat.NV21;


/**
 * <p>网络通话可选项</p>
 * <p><b>每个参数包含以下几个重要方面:</b>
 * <ul>
 * <li>Possible values: 参数可设置值。</li>
 * <li>Writable: 参数是否可设置，所有参数支持可读。</li>
 * <li>Runtime: 参数是否支持运行时设置，调用相关发起通话，接听通话后即代表运行时。</li>
 * <li>Compatibility: 兼容性提示。</li>
 * <li>Labs: 实验功能</li>
 * <li>Units: 参数值单位</li>
 * <li>Range of valid values: 参数可设置值范围。</li>
 * </ul></p>
 */
public class AVChatParameters {


    /**
     * 可选设置项, 可以获取参数是否支持可设置，以及参数是否能够在通话过程中进行操作
     */
    public static class Key<T> implements Serializable {

        private final RtcKey<T> mKey;
        private final boolean mWritable;
        private final boolean mRuntime;

//        /**
//         * @param name 参数名
//         */
//        public Key(final String name) {
//            ParameterizedType thisType = (ParameterizedType) getClass().getGenericSuperclass();
//            Type type = thisType.getActualTypeArguments()[0];
//            mKey = new RtcKey<>(name, (Class<T>) type);
//            mWritable = RtcParameters.writeSupported(name);
//            mRuntime = RtcParameters.runtimeSupported(name);
//        }

        Key(final String name, Class<T> clazz) {
            mKey = new RtcKey<>(name, clazz);
            mWritable = RtcParameters.writeSupported(name);
            mRuntime = RtcParameters.runtimeSupported(name);
        }


        private static class SpecializedKey<T> extends Key<T> {
            SpecializedKey(String name, Class<T> clazz) {
                super(name, clazz);
            }
        }


        /**
         * 创建特殊Key
         *
         * @param name 参数名
         * @return Key
         */
        public static Key<?> createSpecializedKey(final String name) {
            Class<?> clazz = RtcParameters.getKeyType(name);
            if (clazz == null) {
                throw new IllegalArgumentException(
                        "Key " + name + " unsupported！");
            }
            return new SpecializedKey<>(name, clazz);
        }

        /**
         * 参数名
         *
         * @return 返回实际的参数名
         */
        public String name() {
            return mKey.getName();
        }

        /**
         * 是否支持通话过程中设置
         *
         * @return {@code true} 支持
         */
        public boolean runtime() {
            return mRuntime;
        }

        /**
         * 参数是否支持可写，默认所有参数都支持可读
         *
         * @return {@code true} 可写
         */
        public boolean writable() {
            return mWritable;
        }


        /**
         * 参数支持的数据类型
         *
         * @return 数据类型
         */
        public final Class<T> type() {
            return mKey.getType();
        }

        /**
         * {@inheritDoc}
         */
        @Override
        public final int hashCode() {
            return mKey.hashCode();
        }

        /**
         * {@inheritDoc}
         */
        @SuppressWarnings("unchecked")
        @Override
        public final boolean equals(Object o) {
            return o instanceof Key && ((Key<T>) o).mKey.equals(mKey);
        }

        /**
         * {@inheritDoc}
         */
        @Override
        public String toString() {
            return String.format("Key(Name:%s, Type:%s, Writable:%s, Runtime:%s)", name(), type(), writable(), runtime());
        }

    }


    /**
     * <p>默认情况下设备顺时针旋转角度, 某些特殊设备在默认情况下无法获取到设备方向,可指定默认的设备角度。</p>
     *
     * <p>当一个设备水平放置时，它当前的角度是未定义的。 如果一个设备的工作环境永远是水平放置的，那么需要为它制定一个默认的旋转角度。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link Surface#ROTATION_0 ROTATION_0}</li>
     * <li>{@link Surface#ROTATION_90 ROTATION_90}</li>
     * <li>{@link Surface#ROTATION_180 ROTATION_180}</li>
     * <li>{@link Surface#ROTATION_270 ROTATION_270}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     *
     * @see Surface#ROTATION_0
     * @see Surface#ROTATION_90
     * @see Surface#ROTATION_180
     * @see Surface#ROTATION_270
     */
    @Writable
    @IntDef({Surface.ROTATION_0,
            Surface.ROTATION_90,
            Surface.ROTATION_180,
            Surface.ROTATION_270})
    public static final Key<Integer> KEY_DEVICE_DEFAULT_ROTATION = new Key<>(RtcParameters.KEY_DEVICE_DEFAULT_ROTATION, Integer.class);


    /**
     * <p>设备旋转角度修正偏移量。</p>
     *
     * <p>如果存在SDK内部获取的角度和设备实际角度总是存在同样的误差，那么可以这只一个修正偏移量。主要存在一个定制设备有此类问题，大部分手机平板不需要关注此参数。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link Surface#ROTATION_0 ROTATION_0}</li>
     * <li>{@link Surface#ROTATION_90 ROTATION_90}</li>
     * <li>{@link Surface#ROTATION_180 ROTATION_180}</li>
     * <li>{@link Surface#ROTATION_270 ROTATION_270}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     *
     * @see Surface#ROTATION_0
     * @see Surface#ROTATION_90
     * @see Surface#ROTATION_180
     * @see Surface#ROTATION_270
     */
    @Writable
    @IntDef({Surface.ROTATION_0,
            Surface.ROTATION_90,
            Surface.ROTATION_180,
            Surface.ROTATION_270})
    public static final Key<Integer> KEY_DEVICE_ROTATION_FIXED_OFFSET = new Key<>(RtcParameters.KEY_DEVICE_ROTATION_FIXED_OFFSET, Integer.class);


    /**
     * <p>视频硬件编码模式。</p>
     *
     * <p>目前仅支持高通CPU系列的硬件编码，如果设备不支持硬件编码，设置硬件编码后会自动回滚到软件编码模式。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatMediaCodecMode#MEDIA_CODEC_AUTO MEDIA_CODEC_AUTO}</li>
     * <li>{@link AVChatMediaCodecMode#MEDIA_CODEC_HARDWARE MEDIA_CODEC_HARDWARE}</li>
     * <li>{@link AVChatMediaCodecMode#MEDIA_CODEC_SOFTWARE MEDIA_CODEC_SOFTWARE}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Compatibility</b> - 存在设备兼容性问题，部分设备已加入黑名单。</p>
     *
     * @see AVChatMediaCodecMode#MEDIA_CODEC_AUTO
     * @see AVChatMediaCodecMode#MEDIA_CODEC_HARDWARE
     * @see AVChatMediaCodecMode#MEDIA_CODEC_SOFTWARE
     */
    @Runtime
    @Writable
    @StringDef({MEDIA_CODEC_AUTO,
            MEDIA_CODEC_HARDWARE,
            MEDIA_CODEC_SOFTWARE})
    public static final Key<String> KEY_VIDEO_ENCODER_MODE = new Key<>(RtcParameters.KEY_VIDEO_ENCODER_MODE, String.class);


    /**
     * <p>视频硬件解码模式。</p>
     *
     * <p>目前仅支持高通CPU系列的硬件解码，如果设备不支持硬件解码，设置硬件解码后会自动回滚到软件解码模式。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatMediaCodecMode#MEDIA_CODEC_AUTO MEDIA_CODEC_AUTO}</li>
     * <li>{@link AVChatMediaCodecMode#MEDIA_CODEC_HARDWARE MEDIA_CODEC_HARDWARE}</li>
     * <li>{@link AVChatMediaCodecMode#MEDIA_CODEC_SOFTWARE MEDIA_CODEC_SOFTWARE}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Compatibility</b> - 存在设备兼容性问题，部分设备已加入黑名单。</p>
     *
     * @see AVChatMediaCodecMode#MEDIA_CODEC_AUTO
     * @see AVChatMediaCodecMode#MEDIA_CODEC_HARDWARE
     * @see AVChatMediaCodecMode#MEDIA_CODEC_SOFTWARE
     */
    @Runtime
    @Writable
    @StringDef({MEDIA_CODEC_AUTO,
            MEDIA_CODEC_HARDWARE,
            MEDIA_CODEC_SOFTWARE})
    public static final Key<String> KEY_VIDEO_DECODER_MODE = new Key<>(RtcParameters.KEY_VIDEO_DECODER_MODE, String.class);


    /**
     * <p>获取系统是否支持硬件编码。</p>
     *
     * <p>目前仅支持高通CPU系列的硬件编码。</p>
     *
     * <p><b>Writable:</b> {@code false}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Compatibility</b> - 存在设备兼容性问题，部分设备已加入黑名单。</p>
     */
    @Runtime
    public static final Key<Boolean> KEY_VIDEO_SUPPORTED_HW_ENCODER = new Key<>(RtcParameters.KEY_VIDEO_SUPPORTED_HW_ENCODER, Boolean.class);


    /**
     * <p>获取系统是否支持硬件解码。</p>
     *
     * <p>目前仅支持高通CPU系列的硬件解码。</p>
     *
     * <p><b>Writable:</b> {@code false}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Compatibility</b> - 存在设备兼容性问题，部分设备已加入黑名单。</p>
     */
    @Runtime
    public static final Key<Boolean> KEY_VIDEO_SUPPORTED_HW_DECODER = new Key<>(RtcParameters.KEY_VIDEO_SUPPORTED_HW_DECODER, Boolean.class);


    /**
     * <p>语音前处理，降噪，用来消除语音通话的背景噪音。</p>
     *
     * <p>目前支持内置软件语音处理和设备硬件语音处理，SDK默认优先采用设备硬件语音处理。如果有很特殊的使用场景，也可以选择关闭语音处理。</p>
     *
     * <p>不是所有的设备都支持硬件语音处理，对不支持硬件语音处理的设备采用优先硬件语音处理会自动回滚到软件语音处理。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatAudioEffectMode#DISABLE DISABLE}</li>
     * <li>{@link AVChatAudioEffectMode#PLATFORM_BUILTIN PLATFORM_BUILTIN}</li>
     * <li>{@link AVChatAudioEffectMode#SDK_BUILTIN SDK_BUILTIN}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     * <p><b>Compatibility</b> - 部分设备标记支持硬件语音处理，但是实际没有硬件语音处理。 部分设备的硬件语音处理效果很差，需要切换到软件语音处理。</p>
     *
     * @see AVChatAudioEffectMode#DISABLE
     * @see AVChatAudioEffectMode#PLATFORM_BUILTIN
     * @see AVChatAudioEffectMode#SDK_BUILTIN
     */
    @Writable
    @StringDef({DISABLE,
            PLATFORM_BUILTIN,
            SDK_BUILTIN})
    public static final Key<String> KEY_AUDIO_EFFECT_NOISE_SUPPRESSOR = new Key<>(RtcParameters.KEY_AUDIO_EFFECT_NOISE_SUPPRESSOR, String.class);


    /**
     * <p>语音处理, 自动增益</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatAudioEffectMode#DISABLE DISABLE}</li>
     * <li>{@link AVChatAudioEffectMode#PLATFORM_BUILTIN PLATFORM_BUILTIN}</li>
     * <li>{@link AVChatAudioEffectMode#SDK_BUILTIN SDK_BUILTIN}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     *
     * @see AVChatAudioEffectMode#DISABLE
     * @see AVChatAudioEffectMode#PLATFORM_BUILTIN
     * @see AVChatAudioEffectMode#SDK_BUILTIN
     */
    @Writable
    @StringDef({DISABLE,
            PLATFORM_BUILTIN,
            SDK_BUILTIN})
    public static final Key<String> KEY_AUDIO_EFFECT_AUTOMATIC_GAIN_CONTROL = new Key<>(RtcParameters.KEY_AUDIO_EFFECT_AUTOMATIC_GAIN_CONTROL, String.class);


    /**
     * <p>语音前处理，回音抑制, 用来消除语音通话的回音。</p>
     *
     * <p>目前支持内置软件语音处理和设备硬件语音处理，SDK默认优先采用设备硬件语音处理。如果有很特殊的使用场景，也可以选择关闭语音处理。</p>
     *
     * <p>不是所有的设备都支持硬件语音处理，对不支持硬件语音处理的设备采用优先硬件语音处理会自动回滚到软件语音处理。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatAudioEffectMode#DISABLE DISABLE}</li>
     * <li>{@link AVChatAudioEffectMode#PLATFORM_BUILTIN PLATFORM_BUILTIN}</li>
     * <li>{@link AVChatAudioEffectMode#SDK_BUILTIN SDK_BUILTIN}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     * <p><b>Compatibility</b> - 部分设备标记支持硬件语音处理，但是实际没有硬件语音处理。 部分设备的硬件语音处理效果很差，需要切换到软件语音处理。</p>
     *
     * @see AVChatAudioEffectMode#DISABLE
     * @see AVChatAudioEffectMode#PLATFORM_BUILTIN
     * @see AVChatAudioEffectMode#SDK_BUILTIN
     */
    @Writable
    @StringDef({DISABLE,
            PLATFORM_BUILTIN,
            SDK_BUILTIN})
    public static final Key<String> KEY_AUDIO_EFFECT_ACOUSTIC_ECHO_CANCELER = new Key<>(RtcParameters.KEY_AUDIO_EFFECT_ACOUSTIC_ECHO_CANCELER, String.class);


    /**
     * <p>是否允许语音通话时开启距离传感器。</p>
     *
     * <p>在语音通话时，如果开启距离传感器，当检测到手机听筒贴近人脸会自动黑掉屏幕。视频通话时会自动仅用距离传感器。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     */
    @Writable
    public static final Key<Boolean> KEY_AUDIO_CALL_PROXIMITY = new Key<>(RtcParameters.KEY_AUDIO_CALL_PROXIMITY, Boolean.class);


    /**
     * <p>视频清晰度。</p>
     *
     * <p>在视频通话时，可以设置你期望的视频发送分辨率。
     * 实际采集分辨率和你设置的会有一定的区别， 对于{@code 720P} 可能存在 {@code 960x720} 或者 {@code 1280x720}。
     * 更极端的情况下，设备摄像头不支持采集某一档次的清晰度，会自动降低到下一档次。实际采用的清晰度级别可以通过此参数获取。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatVideoQuality#QUALITY_DEFAULT QUALITY_DEFAULT}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_LOW QUALITY_LOW}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_MEDIUM QUALITY_MEDIUM}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_HIGH QUALITY_HIGH}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_480P QUALITY_480P}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_540P QUALITY_540P}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_720P QUALITY_720P}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Compatibility</b> - 部分设置不能支持所有档次的清晰度</p>
     */
    @Writable
    @Runtime
    @IntDef({AVChatVideoQuality.QUALITY_LOW,
            AVChatVideoQuality.QUALITY_MEDIUM,
            AVChatVideoQuality.QUALITY_HIGH,
            AVChatVideoQuality.QUALITY_480P,
            AVChatVideoQuality.QUALITY_540P,
            AVChatVideoQuality.QUALITY_720P,
            AVChatVideoQuality.QUALITY_DEFAULT})
    public static final Key<Integer> KEY_VIDEO_QUALITY = new Key<>(RtcParameters.KEY_VIDEO_QUALITY, Integer.class);


    /**
     * <p>设置视频预览清晰度。</p>
     *
     * <p>如果设置的分辨率小于KEY_VIDEO_QUALITY ， 那么无效 ，设置 QUALITY_DEFAULT 与不设置一样 ，默认为 QUALITY_DEFAULT（ 预览跟随KEY_VIDEO_QUALITY ） <br/>
     * 实际预览分辨率和你设置的会有一定的区别， 对于{@code 720P} 可能存在 {@code 960x720} 或者 {@code 1280x720}。
     * 更极端的情况下，设备摄像头不支持采集某一档次的清晰度，会自动降低到下一档次。</p>
     *
     * <p>注意： 如果设置了预览清晰度 ，那么设备摄像头采集的清晰度将以预览清晰度为标准，这可能导致最终发送分辨率有额外的缩放</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatVideoQuality#QUALITY_DEFAULT QUALITY_DEFAULT（与不设置的效果一样）}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_LOW QUALITY_LOW}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_MEDIUM QUALITY_MEDIUM}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_HIGH QUALITY_HIGH}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_480P QUALITY_480P}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_540P QUALITY_540P}</li>
     * <li>{@link AVChatVideoQuality#QUALITY_720P QUALITY_720P}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Compatibility</b> - 部分设置不能支持所有档次的清晰度</p>
     */
    @Writable
    @Runtime
    @IntDef({AVChatVideoQuality.QUALITY_LOW,
            AVChatVideoQuality.QUALITY_MEDIUM,
            AVChatVideoQuality.QUALITY_HIGH,
            AVChatVideoQuality.QUALITY_480P,
            AVChatVideoQuality.QUALITY_540P,
            AVChatVideoQuality.QUALITY_720P,
            AVChatVideoQuality.QUALITY_DEFAULT})
    public static final Key<Integer> KEY_VIDEO_PREVIEW_QUALITY = new Key<>(RtcParameters.KEY_VIDEO_PREVIEW_QUALITY, Integer.class);


    /**
     * <p>视频绘制时自动旋转。</p>
     *
     * <p>视频绘制时会结合对方发送的画面角度，自己设备当前的角度以及当前视图布局的角度来旋转画面，让画面在任何情况下相对于自己都是正方向。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     */
    @Writable
    @Runtime
    public static final Key<Boolean> KEY_VIDEO_ROTATE_IN_RENDING = new Key<>(RtcParameters.KEY_VIDEO_ROTATE_IN_RENDING, Boolean.class);


    /**
     * <p>多人模式下用户角色设定。</p>
     *
     * <p>普通模式下，允许发送和接收数据。当切换到观众模式时，自己仅接收数据，不再发送数据。</p>
     *
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatUserRole#AUDIENCE AUDIENCE}</li>
     * <li>{@link AVChatUserRole#NORMAL NORMAL}</li>
     * </ul></p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatUserRole#AUDIENCE
     * @see AVChatUserRole#NORMAL
     */
    @Runtime
    @Writable
    @IntDef({AVChatUserRole.AUDIENCE, AVChatUserRole.NORMAL})
    public static final Key<Integer> KEY_SESSION_MULTI_MODE_USER_ROLE = new Key<>(RtcParameters.KEY_SESSION_MULTI_MODE_USER_ROLE, Integer.class);


    /**
     * <p>视频帧率汇报。</p>
     *
     * <p>每2秒会汇报本地预览帧率和对方画面预览帧率。帧率通过 {@link AVChatStateObserver#onVideoFpsReported(String, int)} 上报。</p>
     *
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatStateObserver#onVideoFpsReported(String, int)
     * @see AVChatManager#observeAVChatState(AVChatStateObserverLite, boolean)
     */
    @Runtime
    @Writable
    public static final Key<Boolean> KEY_VIDEO_FPS_REPORTED = new Key<>(RtcParameters.KEY_VIDEO_FPS_REPORTED, Boolean.class);


    /**
     * <p>视频最大码率。</p>
     *
     * <p>设置视频流的最大码率，码率需要结合分辨率来设置，不能设置过小。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Units:</b> bit per seconds(bps)</p>
     * <p><b>Range of valid values:</b> &gt;0 , &lt;5Mbps</p>
     */
    @Runtime
    @Writable
    public static final Key<Integer> KEY_VIDEO_MAX_BITRATE = new Key<>(RtcParameters.KEY_VIDEO_MAX_BITRATE, Integer.class);

    /**
     * <p>视频帧率。</p>
     *
     * <p>设置视频画面期望帧率，由于设备限制，性能等问题可能存在实际帧率和期望帧率不一致。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatVideoFrameRate#FRAME_RATE_5 FRAME_RATE_5}</li>
     * <li>{@link AVChatVideoFrameRate#FRAME_RATE_10 FRAME_RATE_10}</li>
     * <li>{@link AVChatVideoFrameRate#FRAME_RATE_15 FRAME_RATE_15}</li>
     * <li>{@link AVChatVideoFrameRate#FRAME_RATE_20 FRAME_RATE_20}</li>
     * <li>{@link AVChatVideoFrameRate#FRAME_RATE_25 FRAME_RATE_25}</li>
     * </ul></p>
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Units:</b> Frames per second (FPS)</p>
     *
     * @see AVChatVideoFrameRate#FRAME_RATE_5
     * @see AVChatVideoFrameRate#FRAME_RATE_10
     * @see AVChatVideoFrameRate#FRAME_RATE_15
     * @see AVChatVideoFrameRate#FRAME_RATE_20
     * @see AVChatVideoFrameRate#FRAME_RATE_25
     */
    @Writable
    @Runtime
    @IntDef({FRAME_RATE_5,
            FRAME_RATE_10,
            FRAME_RATE_15,
            FRAME_RATE_20,
            FRAME_RATE_25})
    public static final Key<Integer> KEY_VIDEO_FRAME_RATE = new Key<>(RtcParameters.KEY_VIDEO_FRAME_RATE, Integer.class);


    /**
     * <p>视频数据预处理。</p>
     *
     * <p>通过此回调，外部可实现视频数据的预处理。目前提供数据格式为 {@link android.graphics.ImageFormat#NV21}，
     * 数据通过 {@link AVChatStateObserver#onVideoFrameFilter(AVChatVideoFrame, boolean)} 传递给上层，外部需要同步处理此数据。
     * 目前数据回调所在线程不具备 {@link android.opengl.EGLContext} 上下文环境。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatStateObserver#onVideoFrameFilter(AVChatVideoFrame, boolean)
     * @see AVChatManager#observeAVChatState(AVChatStateObserverLite, boolean)
     */
    @Writable
    @Runtime
    public static final Key<Boolean> KEY_VIDEO_FRAME_FILTER = new Key<>(RtcParameters.KEY_VIDEO_FRAME_FILTER, Boolean.class);


    /**
     * <p>视频数据预处理。</p>
     *
     * <p>通过此回调，外部可实现视频数据的预处理。目前提供数据格式为 {@link android.graphics.ImageFormat#NV21,android.graphics.ImageFormat#I420,#GLES11Ext.GL_TEXTURE_EXTERNAL_OES}，
     * 数据通过 {@link AVChatStateObserver#onVideoFrameFilter(VideoFrame, VideoFrame[], VideoFilterParameter)}  传递给上层，外部需要同步处理此数据。
     * 目前数据回调所在线程具备 {@link android.opengl.EGLContext} 上下文环境。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatStateObserver#onVideoFrameFilter(AVChatVideoFrame, boolean)
     * @see AVChatManager#observeAVChatState(AVChatStateObserverLite, boolean)
     */
    @Writable
    @Runtime
    public static final Key<Boolean> KEY_VIDEO_FRAME_FILTER_NEW = new Key<>(RtcParameters.KEY_VIDEO_FRAME_FILTER_NEW, Boolean.class);


    /**
     * <p>视频数据回调图像格式</p>
     *
     * <p>通过回调 {@link AVChatStateObserver#onVideoFrameFilter(AVChatVideoFrame, boolean)} 传出的数据格式。
     * 建议使用 {@link AVChatImageFormat#I420} 格式，默认格式为 {@link AVChatImageFormat#NV21}.</p>
     *
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatImageFormat#NV21}</li>
     * <li>{@link AVChatImageFormat#I420}</li>
     * </ul></p>
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatStateObserver#onVideoFrameFilter(AVChatVideoFrame, boolean)
     * @see AVChatManager#observeAVChatState(AVChatStateObserverLite, boolean)
     */
    @Writable
    @Runtime
    @IntDef({NV21,
            I420})
    public static final Key<Integer> KEY_VIDEO_FRAME_FILTER_FORMAT = new Key<>(RtcParameters.KEY_VIDEO_FRAME_FILTER_FORMAT, Integer.class);


    /**
     * <p>语音数据预处理。</p>
     *
     * <p>通过此回调，外部可实现语音数据的预处理。目前提供外部的数据格式为 {@code PCM}, 数据通过 {@link AVChatStateObserver#onAudioFrameFilter(AVChatAudioFrame)} 传递给上层，
     * 外部需要同步处理此数据。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatStateObserver#onAudioFrameFilter(AVChatAudioFrame)
     * @see AVChatManager#observeAVChatState(AVChatStateObserverLite, boolean)
     */
    @Writable
    @Runtime
    public static final Key<Boolean> KEY_AUDIO_FRAME_FILTER = new Key<>(RtcParameters.KEY_AUDIO_FRAME_FILTER, Boolean.class);


    /**
     * <p>互动直播推流地址。</p>
     *
     * <p>推流地址，仅主播设置，非主播用户不能设置此参数。 如果需要开启直播，必须在通话前设置推流地址，通话过程中可以更新推流地址。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Units:</b> UTF-8 null-terminated string</p>
     *
     * @deprecated 推荐使用 {@link AVChatManagerLite#createRoom(String, String, List, AVChatCallback)}
     */
    @Deprecated
    @Runtime
    @Writable
    public static final Key<String> KEY_SESSION_LIVE_URL = new Key<>(RtcParameters.KEY_SESSION_LIVE_URL, String.class);


    /**
     * <p>声音强度汇报。</p>
     *
     * <p>通话过程中汇报正在说话用户的语音强度。语音强度通过 {@link AVChatStateObserver#onReportSpeaker(Map, int)} 上报给上层。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatStateObserver#onReportSpeaker(Map, int)
     * @see AVChatManager#observeAVChatState(AVChatStateObserverLite, boolean)
     */
    @Writable
    @Runtime
    public static final Key<Boolean> KEY_AUDIO_REPORT_SPEAKER = new Key<>(RtcParameters.KEY_AUDIO_REPORT_SPEAKER, Boolean.class);


    /**
     * <p>高清晰语音。</p>
     *
     * <p>默认情况下不开启高清语音。高清语音将使用高采样率进行语音采集来提升语音的清晰度。</p>
     *
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     * <p><b>Compatibility</b> - 部分设备不支持高清语音采集。</p>
     */
    @Writable
    public static final Key<Boolean> KEY_AUDIO_HIGH_QUALITY = new Key<>(RtcParameters.KEY_AUDIO_HIGH_QUALITY, Boolean.class);


    /**
     * <p>视频采集方向。</p>
     *
     * <p>默认情况下都是竖屏采集，用户可以设置不同的采集方向来调整拉流观众观看的角度。</p>
     *
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatVideoCaptureOrientation#ORIENTATION_PORTRAIT ORIENTATION_PORTRAIT}</li>
     * <li>{@link AVChatVideoCaptureOrientation#ORIENTATION_PORTRAIT_UPSIDEDOWN ORIENTATION_PORTRAIT_UPSIDEDOWN}</li>
     * <li>{@link AVChatVideoCaptureOrientation#ORIENTATION_LANDSCAPE_LEFT ORIENTATION_LANDSCAPE_LEFT}</li>
     * <li>{@link AVChatVideoCaptureOrientation#ORIENTATION_LANDSCAPE_RIGHT ORIENTATION_LANDSCAPE_RIGHT}</li>
     * </ul></p>
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatVideoCaptureOrientation#ORIENTATION_PORTRAIT
     * @see AVChatVideoCaptureOrientation#ORIENTATION_PORTRAIT_UPSIDEDOWN
     * @see AVChatVideoCaptureOrientation#ORIENTATION_LANDSCAPE_LEFT
     * @see AVChatVideoCaptureOrientation#ORIENTATION_LANDSCAPE_RIGHT
     */
    @Writable
    @Runtime
    @IntDef({AVChatVideoCaptureOrientation.ORIENTATION_PORTRAIT,
            AVChatVideoCaptureOrientation.ORIENTATION_PORTRAIT_UPSIDEDOWN,
            AVChatVideoCaptureOrientation.ORIENTATION_LANDSCAPE_LEFT,
            AVChatVideoCaptureOrientation.ORIENTATION_LANDSCAPE_RIGHT})
    public static final Key<Integer> KEY_VIDEO_CAPTURE_ORIENTATION = new Key<>(RtcParameters.KEY_VIDEO_CAPTURE_ORIENTATION, Integer.class);


    /**
     * <p>视频画面裁剪比例。</p>
     *
     * <p>默认情况是视频采集画面不裁剪。 在不同的设备上采集处理的分辨率可能不一样。 比如 {@code 720P} 可能存在 {@code 960x720} 和 {@code 1280x720}。
     * 不同的分辨率会导致在预览绘制时画面存在画面显示不全或者黑边等问题。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatVideoCropRatio#CROP_RATIO_NONE CROP_RATIO_NONE}</li>
     * <li>{@link AVChatVideoCropRatio#CROP_RATIO_16_9 CROP_RATIO_16_9}</li>
     * <li>{@link AVChatVideoCropRatio#CROP_RATIO_4_3 CROP_RATIO_4_3}</li>
     * <li>{@link AVChatVideoCropRatio#CROP_RATIO_1_1 CROP_RATIO_1_1}</li>
     * </ul></p>
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     *
     * @see AVChatVideoCropRatio#CROP_RATIO_NONE
     * @see AVChatVideoCropRatio#CROP_RATIO_16_9
     * @see AVChatVideoCropRatio#CROP_RATIO_4_3
     * @see AVChatVideoCropRatio#CROP_RATIO_1_1
     */
    @Writable
    @Runtime
    @IntDef({AVChatVideoCropRatio.CROP_RATIO_NONE,
            AVChatVideoCropRatio.CROP_RATIO_1_1,
            AVChatVideoCropRatio.CROP_RATIO_4_3,
            AVChatVideoCropRatio.CROP_RATIO_16_9})
    public static final Key<Integer> KEY_VIDEO_FIXED_CROP_RATIO = new Key<>(RtcParameters.KEY_VIDEO_FIXED_CROP_RATIO, Integer.class);


    /**
     * <p>前置摄像头本地预览镜像</p>
     *
     * <p>当使用前置摄像头时，本地预览画面是否镜像。 默认前置摄像头画面镜像处理。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     */
    @Writable
    @Runtime
    public static final Key<Boolean> KEY_VIDEO_LOCAL_PREVIEW_MIRROR = new Key<>(RtcParameters.KEY_VIDEO_LOCAL_PREVIEW_MIRROR, Boolean.class);


    /**
     * <p>前置摄像头发送数据预览镜像</p>
     *
     * <p>当使用前置摄像头时，本地发送画面是否镜像。 默认前置摄像头发送换面不镜像处理。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code true}</p>
     */
    @Runtime
    @Writable
    public static final Key<Boolean> KEY_VIDEO_TRANSPORT_MIRROR = new Key<>(RtcParameters.KEY_VIDEO_TRANSPORT_MIRROR, Boolean.class);


    /**
     * <p>服务器语音录制。</p>
     *
     * <p>在服务器录制通话语音数据，格式为 {@code aac}。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     */
    @Writable
    public static final Key<Boolean> KEY_SERVER_AUDIO_RECORD = new Key<>(RtcParameters.KEY_SERVER_AUDIO_RECORD, Boolean.class);


    /**
     * <p>服务器视频录制。</p>
     *
     * <p>在服务器录制通话视频数据，格式为 {@code mp4}。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     */
    @Writable
    public static final Key<Boolean> KEY_SERVER_VIDEO_RECORD = new Key<>(RtcParameters.KEY_SERVER_VIDEO_RECORD, Boolean.class);


    /**
     * <p>服务器录制模式。</p>
     *
     * <p>设置服务器录制时的模式，混合与单人、混合、单人。</p>
     *
     * <p><b>Possible values:</b>
     * <ul>
     * <li>{@link AVChatServerRecordMode#MIX_AND_SINGLE MIX_AND_SINGLE}</li>
     * <li>{@link AVChatServerRecordMode#MIX MIX}</li>
     * <li>{@link AVChatServerRecordMode#SINGLE SINGLE}</li>
     * </ul></p>
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     *
     * @see AVChatServerRecordMode#MIX_AND_SINGLE
     * @see AVChatServerRecordMode#MIX
     * @see AVChatServerRecordMode#SINGLE
     */
    @Writable
    @Runtime
    @IntDef({MIX_AND_SINGLE,
            MIX,
            SINGLE})
    public static final Key<Integer> KEY_SERVER_RECORD_MODE = new Key<>(RtcParameters.KEY_SERVER_RECORD_MODE, Integer.class);


    /**
     * <p>服务器录制是否为主讲人。</p>
     *
     * <p>在服务器录制开始时设置是否为主讲人。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     */
    @Writable
    public static final Key<Boolean> KEY_SERVER_RECORD_SPEAKER = new Key<>(RtcParameters.KEY_SERVER_RECORD_SPEAKER, Boolean.class);


    /**
     * <p>服务器互动直播录制。</p>
     *
     * <p>在服务器录制互动直播内容。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     *
     * @deprecated 推荐使用 {@link AVChatManagerLite#createRoom(String, String, List, AVChatCallback)}
     */
    @Deprecated
    @Writable
    public static final Key<Boolean> KEY_SERVER_LIVE_RECORD = new Key<>(RtcParameters.KEY_SERVER_LIVE_RECORD, Boolean.class);


    /**
     * <p>互动直播混屏模式。</p>
     *
     * <p>当互动直播时有连麦用户加入，可以指定不同当混屏模式。用户可以使用简单的混合模式，也可以自定义复杂的混合模式</p>
     *
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     *
     * @see <a href="http://netease.im/blog/12-3">http://netease.im/blog/12-3</a>
     * @deprecated 推荐使用 {@link AVChatManagerLite#createRoom(String, String, List, AVChatCallback)}
     */
    @Deprecated
    @Writable
    public static final Key<AVChatLiveCompositingLayout> KEY_SESSION_LIVE_COMPOSITING_LAYOUT =
            new Key<>(RtcParameters.KEY_SESSION_LIVE_COMPOSITING_LAYOUT, AVChatLiveCompositingLayout.class);


    /**
     * <p>互动直播模式。</p>
     *
     * <p>开启互动直播前提是需要多人会议模式， 必须通过 {@link AVChatManager#joinRoom2(String, AVChatType, AVChatCallback)} 来加入房间。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     *
     * @see AVChatManager#createRoom(String, String, List, AVChatCallback)
     * @see AVChatManager#joinRoom2(String, AVChatType, AVChatCallback)
     * @see AVChatManager#leaveRoom2(String, AVChatCallback)
     */
    @Writable
    public static final Key<Boolean> KEY_SESSION_LIVE_MODE = new Key<>(RtcParameters.KEY_SESSION_LIVE_MODE, Boolean.class);

    /**
     * <p>自定义服务器兼容性配置</p>
     *
     * <p>该参数设置一个URL地址，以指定一个远端JSON配置文件，由SDK负责下载后解析，并缓存在本地。
     * 每次加载时，如果对应缓存有效，SDK优先使用缓存的配置；否则，本次仅完成下载和解析工作，配置会在下一次通话时才能应用。
     * SDK会间隔15分钟去同步远端配置文件的修改，重新下载、解析并缓存。
     * </p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     */
    @Writable
    public static final Key<String> KEY_COMPATIBILITY_CONFIG_SERVER =
            new Key<>(RtcParameters.KEY_COMPATIBILITY_CONFIG_SERVER, String.class);

    /**
     * <p>自定义本地兼容性配置</p>
     *
     * <p>该参数设置一个本地文件路径，以指定一个本地兼容性配置文件供SDK解析应用。
     * 每次启用，SDK都会重新解析本地配置文件。对于相同的配置项，本地适配会优先于服务器适配。</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     */
    @Writable
    public static final Key<String> KEY_COMPATIBILITY_CONFIG_LOCAL =
            new Key<>(RtcParameters.KEY_COMPATIBILITY_CONFIG_LOCAL, String.class);


    /**
     * <p>外部语音数据采集</p>
     *
     * <p>用户在SDK外部采集语音数据，然后按照一定格式传入SDK内部编码发送</p>
     *
     * <p><b>Writable:</b> {@code true}</p>
     * <p><b>Runtime:</b> {@code false}</p>
     *
     * @Deprecated 推荐使用 {@link AVChatManager#setExternalAudioSource(boolean)}<br/>
     * @see AVChatManager#pushExternalAudioData(byte[], int, int, int, int, boolean)
     */
    @Writable
    @Deprecated
    public static final Key<Boolean> KEY_AUDIO_EXTERNAL_CAPTURE =
            new Key<>(RtcParameters.KEY_AUDIO_EXTERNAL_CAPTURE, Boolean.class);

    /**
     * 语音播放采样率设置
     */
    @Writable
    public static final Key<Integer> KEY_AUDIO_PROCESS_DUMP_FLAG_DEBUG =
            new Key<>(RtcParameters.KEY_AUDIO_PROCESS_DUMP_FLAG_DEBUG, Integer.class);


    /**
     * 设置是否打印 kTraceProfile 日志
     */
    @Writable
    @Runtime
    public static final Key<Boolean> KEY_PROFILE_TRACE_FLAG_DEBUG =
            new Key<>(RtcParameters.KEY_PROFILE_TRACE_FLAG_DEBUG, Boolean.class);


    /**
     * 语音播放采样率设置
     */
    @Writable
    @IntDef({AVChatAudioSampleRate.SAMPLE_RATE_8000_HZ,
            AVChatAudioSampleRate.SAMPLE_RATE_16000_HZ,
            AVChatAudioSampleRate.SAMPLE_RATE_32000_HZ,
            AVChatAudioSampleRate.SAMPLE_RATE_48000_HZ})
    public static final Key<Integer> KEY_AUDIO_PLAYBACK_DEFAULT_SAMPLE_RATE =
            new Key<>(RtcParameters.KEY_AUDIO_PLAYBACK_DEFAULT_SAMPLE_RATE, Integer.class);


    private RtcParameters mRawParams;

    public AVChatParameters() {
        mRawParams = new RtcParameters();
    }

    public void clear() {
        mRawParams.clear();
    }

    public RtcParameters getRawParameters() {
        return mRawParams;
    }

    public void setRawParameters(RtcParameters parameters) {
        mRawParams = new RtcParameters();

        Set<String> keys = parameters.keys();

        if (keys != null) {
            for (String key : keys) {
                mRawParams.setObject(key, parameters.getObject(key));
            }
        }
    }

    public final AVChatParameters setRequestKeys(Set<Key> keys) {
        checkNotNull(keys);

        Set<String> keyName = new HashSet<>(keys.size());
        for (Key key : keys) {
            keyName.add(key.name());
        }
        mRawParams.setRequestKeys(keyName);
        return this;
    }


    public final AVChatParameters setRequestKey(Key key) {
        checkNotNull(key);
        mRawParams.setRequestKey(key.name());
        return this;
    }


    public final boolean getBoolean(Key<Boolean> key) {
        return get(key);
    }

    public final int getInteger(Key<Integer> key) {
        return get(key);
    }

    public final String getString(Key<String> key) {
        return get(key);
    }

    public final void setInteger(Key<Integer> key, int value) {
        set(key, value);
    }

    public final void setBoolean(Key<Boolean> key, boolean value) {
        set(key, value);
    }

    public final void setString(Key<String> key, String value) {
        set(key, value);
    }

    public final boolean containsKey(Key key) {
        checkNotNull(key);
        return mRawParams.containsKey(key.name());
    }

    public final <T> void set(Key<T> key, T value) {
        checkNotNull(key);
        mRawParams.setObject(key.name(), value);
    }

    public final <T> T get(Key<T> key) {
        checkNotNull(key);
        T value = (T) mRawParams.getObject(key.name());
        return value;
    }

    public final void setFloat(Key<Float> key, float value) {
        set(key, value);
    }

    public final float getFloat(Key<Float> key) {
        return get(key);
    }

    public final void removeParameters(Key key) {
        checkNotNull(key);
        mRawParams.removeParameters(key.name());
    }


    private static <T> T checkNotNull(T reference) {
        if (reference == null) {
            throw new NullPointerException();
        }
        return reference;
    }


}