android {
   //android标签内添加aar目录
    repositories {
        flatDir {
            dirs 'libs'
        }
    }
}

dependencies {
	//添加依赖
	compile fileTree(dir: 'libs', include: ['*.jar'])
    compile(name: 'gameboxlib-veriosn-xxx', ext: 'aar')
}

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

-keepattributes SourceFile,LineNumberTable,Signature

-keepclasseswithmembernames class * {
    native <methods>;
}
-keep class com.alibaba.fastjson.** { *; }
-keep class com.mci.** { *; }

  /**
     * 初始化sdk
     *
     * @param ak appKey
     * @param sk secKey
     */
    public void init(String ak, String sk, String dc);

List<GameInfo> gameList = GameBoxManager.getInstance(this).queryGameList(int start,int limit)

GameInfo gidGameInfo = GameBoxManager.getInstance(this).queryGame(int gid)

List<GameInfo> pkgGameList = GameBoxManager.getInstance(this).queryGames(String pkg)

List<GameInfo> pkgGameList = GameBoxManager.getInstance(this).queryNameGames(String appName)

GameInfo gameInfo = GameBoxManager.getInstance(this).updateGameInfo(GameInfo info)

GameBoxManager.getInstance(this).applyCloudDevice(@NonNull GameInfo gameInfo, 
	@NonNull new APICallback<DeviceControl>(){
	            @Override
            public void onAPICallback(DeviceControl deviceControl, int code) {
                //回调
            }
	})

GameBoxManager.getInstance(this).applyCloudDevice(@NonNull GameInfo gameInfo,  boolean playQueue,String tagKey, HashMap<String,String> scriptMap,
	@NonNull new APICallback<DeviceControl>(){
	            @Override
            public void onAPICallback(DeviceControl deviceControl, int code) {
                //回调
            }
	})

   DeviceControl.startGame(@NonNull FragmentActivity activity, @IdRes int containerId, 
	@NonNull APICallback<String> callback)

/**
 * 设置试玩监听
 * @param listener    PlayListener 回调
 */
public abstract void setPlayListener(PlayListener listener);


/**
 * 试玩监听
 */
public interface PlayListener {
    /**
     * 网络延时反馈
     *
     * @param ping 网络延时，单位ms
     */
    void onPingUpdate(int ping);

        /**
         * 无操作超时回调
         *
         * @param type    类型。1为后台，2为前台
         * @param timeout 超时时长，单位s
         * @return 返回true表示消耗了事件，sdk不处理超时逻辑；返回false表示未消耗事件，在倒计时结束后，sdk会停止试玩
         */
    boolean onNoOpsTimeout(int type, long timeout);
    
        /**
         * 设备信息返回
         *
         * @param info 统计信息json format
         */
    void onPlayInfo(String info){
        "downRate":%d,                 //总下行流量
        "upRate":%d,                     //总上行流量
        "videoFps":%d,                  //实时视频帧率
        "videoBitrate":%d,             //视频码率
        "rtt":%d,                             //RTT
       "screenFps":%d,               //刷新率
        "captureTimeAvg":%d,    //平均采集耗时
        "captureTimeMax":%d,    //最大采集耗时
        "captureTimeMin":%d,     //最小采集耗时
        "videoEncodingTimeAvg":%d,  //平均编码耗时
        "videoEncodingTimeMax":%d,  //最大编码耗时
        "videoEncodingTimeMin":%d,   //最小编码耗时
        "packetLoss":%.2f,                    //丢包率
        "decodeTimeAvg":%d,        //平均解码耗时
        "decodeTimeMax":%d,       //最大解码耗时
        "decodeTimeMin":%d,         //最小解码耗时
        "videoRendererFps":%d     //渲染帧率
       }
       /**
         * 屏幕亮度回调
         *
         * @param bright
         */
     void onOutputBright(float bright);

	/**
     * 设置试玩倒计时监听
     * @param threshold 阈值，到达开始倒计时回调，如果小于等于0，则从设置监听起开始回调
     * @param listener 监听listener
     */
    public abstract void setTimeCountDownListener(int threshold, TimeCountDownListener listener);


/**
 * 试玩结束倒计时监听
 */
public interface TimeCountDownListener {
    /**
     * 倒计时触发
     *
     * @param remainingTime 剩余时间，单位s秒
     */
    void countDown(int remainingTime);
}

/**
 * 设置无操作超时  (modified v1.5.3)
 * @param foregroundTimeout 前台超时，单位s
 * @param backgroundTimeout 后台超时，单位s
 */
public abstract void setNoOpsTimeout(long foregroundTimeout, long backgroundTimeout);

    /**
     * 调整试玩的码率
     * @param level 等级，目前支持5档
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_AUTO} 自动
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_HD} 高清switchQuality
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_ORDINARY} 普通
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_HS} 一般
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_LS} 流畅
     */
    public abstract void switchQuality(@APIConstants.VideoQuality String level);

  /**
    * 设置游戏分辨率,支持四档,从高档到低档
    * @param infos
    */
public abstract void setVideoLevels(List<GameQualityInfo> infos);

/**
 * 动态设置分辨率 设置后马上生效
 * @param info
 */
public abstract void setVideoLevel(GameQualityInfo info);

    /**
     * 
     * 
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_AUTO} 自动
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_HD} 高清switchQuality
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_ORDINARY} 普通
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_HS} 一般
     * {@link APIConstants#DEVICE_VIDEO_QUALITY_LS} 流畅
     */
    public abstract @APIConstants.VideoQuality String getDefaultGameLevel();

    /**
     * 
     * 设置视频流显示模式，默认自动切换，需要在startGame之前调用
     */
   public abstract void setVideoOrientation(int orientation);

    /**
     * 试玩声音开关
     * @param audioSwitch
     */
    public abstract void setAudioSwitch(boolean audioSwitch);

   /**
     * 发送按键事件
     * @param keyCode 使用红手指的{@link com.mci.play.MCIKeyEvent}里面的code
     *                MCIKeyEvent.KEYCOED_VOLUME_UP    音量增加
     *                MCIKeyEvent.KEYCOED_VOLUME_DOWN  音量减少
     */
    public abstract void sendKeyEvent(int keyCode);

/**
  * 切回到前台调用,会继续解析音视频,流会继续推送.
  */
public abstract void resume();

/**
  * 切到后台调用,会停止解析音视频,流会继续推送
  */
public abstract void pause();

    /**
     * 停止试玩，在退出试玩的时候必须回调，否则无法进行下一次试玩
     */
    public abstract void stopGame();

    /**
     * 停止试玩，在退出试玩的时候必须回调，否则无法进行下一次试玩
     */
   public abstract void stopGame(HashMap<String,Object> scriptMap);

### 排队机制

排队机制是在原有设备申请接口上新增的机制，在设备使用高峰期可以帮助产品挽留用户。排队过程中只能同时一款游戏进行排队，排队过程中可以申请进入其他有空闲设备的机器。

#### 设置会员等级

会员等级分为普通会员`MemberLevel.NORMAL`、VIP会员`MemberLevel.VIP`、超级VIP会员`MemberLevel.SUPER_VIP`，默认为普通会员。开发者可以与自己的会员体系进行映射，会议会影响加速效果，在加速之前可通过`GameBoxManager`先进行全局的会员等级设置。

```java
   /**
     * 设置会员等级
     *
     * @param memberLevel
     */逻辑
    public void setMemberLevel(MemberLevel memberLevel) {
        mMemberLevel = memberLevel;
    }

    /**
     * 获取当前会员等级
     *
     * @return
     */
    public MemberLevel getMemberLevel() {
        return mMemberLevel;
    }

    /**
     * 根据游戏信息申请试玩设备
     *
     * @param gameInfo  游戏信息
     * @param playQueue 如果没有设备是否自动进入队列
     * @param callback  异步回调
     */
GameBoxManager.getInstance(this).applyCloudDevice(@NonNull GameInfo gameInfo, boolean playQueue,
    @NonNull new APICallback<DeviceControl>(){
                @Override
            public void onAPICallback(DeviceControl deviceControl, int code) {
                //回调
            }
    })

/**
     * 加入队列，获取队列状态
     *
     * @param gameInfo      游戏信息
     * @param checkInterval 队列检测时间间隔，单位秒
     * @param callback      回调
     */
     GameManager.getInstance(this).joinQueue(GameInfo gameInfo, int checkInterval, APICallback<QueueRankInfo> callback);


/**  如需使用脚本,可以传入scriptMap
     * @param tagKey     分组标签
     * @param scriptMap     脚本map
     */
    GameManager.getInstance(this).joinQueue(GameInfo gameInfo, int checkInterval, APICallback<QueueRankInfo> callback,String tagKey,HashMap<String,Object> scriptMap);

    /**
     * 注册排队监听回调
     * @param callback 回调
     */
    public void registerQueueCallback(APICallback<QueueRankInfo> callback);

public class QueueRankInfo {
			//游戏信息
		    public GameInfo gameInfo;
		    //当前排名
		    public int queueRanking;
		    //预估时间，单位毫秒，不准确
		    public long queueWaitTime;
}

	/** 队列更新 */
    public static final int QUEUE_UPDATE = 1004;
    /** 队列加速前 */
    public static final int QUEUE_ACCELERATE_BEFORE = 1005;
    /** 队列加速后 */
    public static final int QUEUE_ACCELERATE_AFTER = 1006;
    /** 排队成功 */
    public static final int QUEUE_SUCCESS = 1007;
    /** 队列退出 */
    public static final int QUEUE_EXIT = 1008;
    /** 排队失败 */
    public static final int QUEUE_FAILED = 1009;
    /** 不存在队列，直接申请*/
    public static final int QUEUE_NO_QUEUE = 1010;

  /**
     * 队列加速
     * @param accCount 加速前进数量
     */
	GameManager.getInstance(this).accelerateQueue(int accCount)
    
    /** 如需使用脚本,可以传入scriptMap
     * @param scriptMap     脚本map
     * @param tagKey     分组标签
     */
    GameManager.getInstance(this).accelerateQueue(int accCount, String tagKey, HashMap< String, Object > scriptMap);

  /**
     * 退出队列
     */
    GameManager.getInstance(this).exitQueue() 
    
    /**
     * 指定标签退出队列
     */
   GameManager.getInstance(this).exitQueue(String tagKey) 

    /**
     * 生成设备连接信息，用于跨进程调用
     *
     * @return
     */
    public  String getDeviceToken();

    /**
     *  根据已有设备Token还原设备链接信息
     * @param deviceToken 设备token
     * @param callback 回调
     */
GameBoxManager.getInstance(this).applyCloudDeviceWithToken(String deviceToken, 
 @NonNull new APICallback<DeviceControl>(){
                @Override
            public void onAPICallback(DeviceControl deviceControl, int code) {
                //回调
            }
    })

/**
 * 向当前启动的云手机App发送消息，消息格式自定义
 *
 * @param map
 */
 public abstract void sendMessageToDevice(Map<String, String> data);

    /**
     * 注册监听，接收云手机App返回的消息
     *
     * @param listener
     */
    public abstract void registerDataTransferListener(DataTransferListener listener);

    /**
     * 云手机消息接收监听
     */
    public interface DataTransferListener {

        /**
         * 接收到云手机消息回掉
         *
         * @param data 消息未自定义格式
         */
        void onReceiveData(Map<String, String> data);

        /**
         * 消息发送失败
         *
         * @param code
         */
        void onSendFailed(int code);
    }

  /**
     * 注册监听，接收硬件采集信息
     *
     * @param listener
     */
    public abstract void registerSensorSamplerListener(SensorSamplerListener listener);

    /**
     * 采集硬件信息回掉
     */
    public interface SensorSamplerListener {

        /**
         * 采集硬件信息状态发生变化
         *
         * @param sensor 硬件类型  @SensorConstants.CloudPhoneSensorId
         * @param state  硬件状态  @SensorConstants.SensorState
         */
        void onSensorSamper(@SensorConstants.CloudPhoneSensorId int sensor,
                            @SensorConstants.SensorState int state);
    }

    /**
     * 发送硬件信息，此接口针对摄像头和麦克风数据
     *
     * @param type 硬件类型 @{@SensorConstants.CloudPhoneSensorId}
     * @param type 数据@{@SensorConstants.CameraVideoType}
     * @return
     */
    public abstract void sendSensorInputData(@SensorConstants.CloudPhoneSensorId int sendor,
                                             @SensorConstants.AudioType @SensorConstants.CameraVideoType int type,
                                             byte[] data);

    /**
     * 发送硬件传感器信息，此接口针对陀螺仪、加速器、重力感应等传感器
     * @param sendor 传感器id @{@SensorConstants.CloudPhoneSensorId}
     * @param sensorType @{传感器类型 SensorConstants.SensorType}
     * @param data 传感器数据参数
     */
    public abstract void sendSensorInputData(@SensorConstants.CloudPhoneSensorId int sendor,
                                             @SensorConstants.SensorType int sensorType,
                                             float... data);