初始化及登录

• 初始化SDK
• 设置登录参数
• 设置通知回调监听
• 验证参数是否正确，登陆SDK

1、初始化SDK

//判断SDK是否已经初始化
if(!ECDevice.isInitialized()) {
 /*  initial: ECSDK 初始化接口
            * 参数：
            *     inContext - Android应用上下文对象
            *     inListener - SDK初始化结果回调接口，ECDevice.InitListener
            *
            * 说明：示例在应用程序创建时初始化 SDK引用的是Application的上下文，
            *       开发者可根据开发需要调整。
            */
      ECDevice.initial(getApplicationContext(), new ECDevice.InitListener() {
           @Override
            public void onInitialized() {
            // SDK已经初始化成功
            Log.i("","初始化SDK成功");
            //设置登录参数，可分为自定义方式和VoIP验密方式。
            //设置通知回调监听包含登录状态监听，接收消息监听，VoIP呼叫事件回调监听和设置接收VoIP来电事件通知Intent等。
            //验证参数是否正确，登陆SDK。     
            }              
            @Override
            public void onError(Exception exception) {
            //在初始化错误的方法中打印错误原因
            Log.i("","初始化SDK失败"+exception.getMessage());
                }
                    });}
            // 已经初始化成功，后续开发业务代码。
            Log.i(TAG, "初始化SDK及登陆代码完成");

• 初始化不要在application的onCreate方法中进行调用，因为如果android的application没有创建完成时执行初始化方法，将会导致初始化无效，在后续的登录和其他接口的调用中出现问题。
• 如果调用初始化触发初始化失败onError回调。可能是由下列原因造成：

• 初始化的时候Couldn't find "libserphone.so"等找不到so的问题？

2、设置登录参数

2.1 任意帐号体系(即自定义登录方式)        

    //创建登录参数对象
    ECInitParams params = ECInitParams.createParams();
    //设置用户登录账号
    params.setUserid("推荐使用客户项目APP的登录帐号，测试阶段Userid可以填写手机号"); 
    //设置AppId
    params.setAppKey("应用ID；登陆官网查看控制台→应用列表→应用管理→APP ID");
    //设置AppToken
    params.setToken("应用Token；登陆官网查看控制台→应用列表→应用管理→APP TOKEN "); 
    //设置登陆验证模式：自定义登录方式
    params.setAuthType(ECInitParams.LoginAuthType.NORMAL_AUTH);
    //LoginMode（强制上线：FORCE_LOGIN  默认登录：AUTO。使用方式详见注意事项）
    params.setMode(ECInitParams.LoginMode.FORCE_LOGIN);

2.2 固定VoIP帐号体系(即VoIP验密登录方式)      

    //创建登录参数对象
    ECInitParams params = ECInitParams.createParams();
    //设置用户登录账号（VoIP帐号）
    params.setUserid("VoIP帐号；通过创建子帐户接口获得");
    //设置账号密码（VoIP密码）
    params.setPwd("VoIP密码；通过创建子帐户接口获得");
    //设置AppId
    params.setAppKey("应用ID；登陆官网查看控制台→应用列表→应用管理→APP ID ");
    //设置登陆验证模式：VoIP验密登录方式
    params.setAuthType(ECInitParams.LoginAuthType.PASSWORD_AUTH);
    //LoginMode（强制上线：FORCE_LOGIN  默认登录：AUTO）
    params.setMode(ECInitParams.LoginMode.FORCE_LOGIN);

• 相同终端(例如安卓手机和安卓手机)之间不可以登录同一账号，移动设备（例如安卓手机和苹果手机）之间不可以登录同一账号。移动设备、平板、电脑设备、Web、PC之间可以登录相同账号。
• 自定义方式（NORMAL_AUTH）登录时候时Userid不可填VoIP帐号，否则会导致VoIP密码失效。
• 两种登录模式的使用：

• SDK三种情况后会自动重连

3、设置通知回调监听

• 登录回调监听将SDK登录状态反馈给APP层，是所有通讯功能的基础，因此必须设置。
• 其他关于IM、VoIP通话、音视频功能的回调监听可根据业务使用情况进行增减，相互之间没有影响。

3.1 登录回调监听

    //设置登录回调监听
    ECDevice.setOnDeviceConnectListener(new ECDevice.OnECDeviceConnectListener() {
            public void onConnect() {
              //兼容旧版本的方法，不必处理
            }
            @Override
            public void onDisconnect(ECError error) {
            //兼容旧版本的方法，不必处理
            }
                        
            @Override
            public void onConnectState(ECDevice.ECConnectState state, ECError error) {
                if(state == ECDevice.ECConnectState.CONNECT_FAILED ){
                   if(error.errorCode == SdkErrorCode.SDK_KICKED_OFF) {
                                Log.i("","==帐号异地登陆");        
                   }
                   else
                   {
                       Log.i("","==其他登录失败,错误码："+ error.errorCode);
                   }
                    return ;
                }
                else if(state == ECDevice.ECConnectState.CONNECT_SUCCESS) {
                       Log.i("","==登陆成功");
                }
            }
        });

3.2 IM接收消息监听

    //IM接收消息监听，使用IM功能的开发者需要设置。
    ECDevice.setOnChatReceiveListener(new OnChatReceiveListener() {
        @Override
        public void OnReceivedMessage(ECMessage msg) {
        Log.i("","==收到新消息");
        }


        @Override
        public void OnReceiveGroupNoticeMessage(ECGroupNoticeMessage notice) {
        //收到群组通知消息,可以根据ECGroupNoticeMessage.ECGroupMessageType类型区分不同消息类型
        Log.i("","==收到群组通知消息（有人加入、退出...）");
        }


        @Override
        public void onOfflineMessageCount(int count) {
            // 登陆成功之后SDK回调该接口通知帐号离线消息数
        }


        @Override
        public void onReceiveOfflineMessage(List msgs) {
            // SDK根据应用设置的离线消息拉取规则通知应用离线消息
        }


        @Override
        public void onReceiveOfflineMessageCompletion() {
            // SDK通知应用离线消息拉取完成
        }


        @Override
        public void onServicePersonVersion(int version) {
            // SDK通知应用当前帐号的个人信息版本号
        }
    });

3.3 VoIP通话状态监听

    // VoIP通话状态监听，使用VoIP通话功能的开发者需要设置。
    ECVoIPCallManager callInterface = ECDevice.getECVoIPCallManager();
    if(callInterface != null) {
        callInterface.setOnVoIPCallListener(new ECVoIPCallManager.OnVoIPListener() {
            @Override
            public void onCallEvents(ECVoIPCallManager.VoIPCall voipCall) {
                // 处理呼叫事件回调
                if(voipCall == null) {
                    Log.e("SDKCoreHelper", "handle call event error , voipCall null");
                    return ;
                 }
                 // 根据不同的事件通知类型来处理不同的业务
                 ECVoIPCallManager.ECCallState callState = voipCall.callState;
                switch (callState) {
                    case ECCALL_PROCEEDING:
                    Log.i("","正在连接服务器处理呼叫请求，callid："+voipCall.callId);
                        break;
                    case ECCALL_ALERTING:
                    Log.i("","呼叫到达对方，正在振铃，callid："+voipCall.callId);
                        break;
                    case ECCALL_ANSWERED:
                    Log.i("","对方接听本次呼叫,callid："+voipCall.callId);
                        break;
                    case ECCALL_FAILED:
                        // 本次呼叫失败，根据失败原因进行业务处理或跳转
                    Log.i("","called:"+voipCall.callId+",reason:"+ voipCall.reason);
                        break;
                    case ECCALL_RELEASED:
                        // 通话释放[完成一次呼叫]
                        break;
                    default:
                        Log.e("SDKCoreHelper", "handle call event error , callState " + callState);
                        break;
                }
            }
        });
    } 

3.4 音视频会议回调监听

    //音视频会议回调监听，使用音视频会议功能的开发者需要设置。
    if(ECDevice.getECMeetingManager() != null) {
            ECDevice.getECMeetingManager().setOnMeetingListener(new OnMeetingListener() {
                @Override
                Public void onReceiveInterPhoneMeetingMsg(ECInterPhoneMeetingMsg msg) {
                    // 处理实时对讲消息Push
                }


                @Override
                public void onReceiveVoiceMeetingMsg(ECVoiceMeetingMsg msg) {
                    // 处理语音会议消息push
                }


                @Override
                public void onReceiveVideoMeetingMsg(ECVideoMeetingMsg msg) {
                    // 处理视频会议消息Push
                }
            });
        }

    // 接收来电时，需要设置接收VoIP来电事件通知Intent。用于SDK回调对应的activity。
    // 呼入activity在sdk初始化的回 调onInitialized中设置。
    // 呼入界面activity、开发者需创建或修改VoIPCallActivity类,可参考demo中的
    // VoIPCallActivity.java(demo中的目录：\app\src\main\java\com\yuntongxun\ecdemo\ui\voip)
        Intent intent = new Intent(getInstance().mContext, VoIPCallActivity.class);
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        PendingIntent pendingIntent = PendingIntent.getActivity( getInstance().mContext, 0, intent, 
        PendingIntent.FLAG_UPDATE_CURRENT);
        ECDevice.setPendingIntent(pendingIntent);    

4、登录SDK

 //验证参数是否正确
 if(params.validate()) {
    // 登录函数
    ECDevice.login(params);
    }