初始化SDK及登录

在程序入口初始化SDK并设置回调接口 — 初始化要在程序完全启动(即Android Application 创建完成)之后才能调用。初始化及登录建议在一个函数体中顺序调用。

代码可参考Demo中的SDKCoreHelper.java(所在的demo目录:\app\src\main\java\com\yuntongxun\ecdemo\ui)

初始化及登陆过程分由以下四步组成:

(1) 初始化SDK

(2) 设置登录参数

(3) 设置通知回调监听

(4) 验证参数是否正确,登陆SDK

特别提醒:设置登录参数、通知回调监听和验证参数是否正确,登陆SDK,需要在SDK初始化成功的方法(onInitialized回调)后执行。

1、初始化SDK

初始化SDK 是调用其他功能(IM,实时音视频,音视频会议等)的前提,如果初始化不成功,后续的接口都无法调用。

初始化示例代码如下:


//判断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及登陆代码完成");


	

注意事项:

(1)初始化不要在application的onCreate方法中进行调用,因为如果android的application没有创建完成时执行初始化方法,将会导致初始化无效,在后续的登录和其他接口的调用中出现问题。

(2)如果调用初始化触发初始化失败onError回调。可能是由下列原因造成:

a、可能SDK已经处于初始化状态(未做ECDevice.isInitialized判断时出现)

b、SDK所声明必要的权限未在清单文件(AndroidManifest.xml)里配置、或者未配置服务属性android:exported="false";

c、当前手机设备系统版本低于SDK所支持的最低版本(当前SDK支持Android Build.VERSION_CODES.FROYO 以及以上版本)

2、设置登录参数

初始化成功之后我们就可以进行登录。登录有两种模式,我们选择其中一种登录方式即可:

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

(2)VoIP帐号体系(即VoIP验密登录方式)

注:推荐使用(1)自定义登录方式。因为此方式下云通讯平台不验证用户的登录密码,只进行应用级的验证。提高客户帐号创建的自由度和使用的便捷性。

示例代码如下:

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


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


	

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


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

	

注意事项:

(1)相同终端之间不可以登录同一账号,移动设备之间不可以登录同一账号。移动设备、平板、电脑设备、Web、PC之间可以登录相同账号。

(2)自定义方式(NORMAL_AUTH)登录时候时Userid不可填VoIP帐号,否则会导致VoIP密码失效。

(3)两种登录模式的使用:

a、FORCE_LOGIN :强制登录,可以强制上线,踢掉已经在线的同终端设备。

b、AUTO:自动重连

建议在首次登陆时使用FORCE_LOGIN强制上线登录模式,之后再次启动APP时使用AUTO自动重连模式。

(4)SDK三种情况后会自动重连

a、登录方式为FORCE_LOGIN类型并且登陆成功

b、客户端使用AUTO登录方式并登陆成功

c、手机网络状态改变

(5)自定义登录方式和VoIP验密登录方式在开发者正式项目中只可选用一种。

3、设置通知回调监听

登录参数设置完成后,开发者可根据业务需要设置回调监听。如下表所示:

监听

说明

约束

OnECDeviceConnectListener

登录回调监听

必须设置

OnChatReceiveListener

IM接收消息监听

使用IM功能时设置

OnVoIPListener

VoIP通话状态监听

使用VoIP功能时设置

OnMeetingListener

音视频会议回调监听

使用音视频会议时设置

说明:

(1)登录回调监听将SDK登录状态反馈给APP层,是所有通讯功能的基础,因此必须设置。

(2)其他关于IM、VoIP通话、音视频功能的回调监听可根据业务使用情况进行增减,相互之间没有影响。

示例代码如下:


    //设置登录回调监听
    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("","==登陆成功");
                }
            }
        });

    //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通知应用当前帐号的个人信息版本号
        }
    });
    
    // 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;
                }
            }
        });
    } 

    //音视频会议回调监听,使用音视频会议功能的开发者需要设置。
    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);


	

注意事项:

回调监听要放在初始化成功的onInitialized回调方法里面,这样保证登录成功之后就可以接收到他人的来电、消息、会议等。

4、登录SDK

设置完成登录参数和通知回调监听,接下来调用验证参数并登录SDK。如果返回是true,则说明参数正确。

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

接下来我们可以测试是否登录成功。调试登录回调监听(ECDevice.OnECDeviceConnectListener)来判断连接状态。登录成功的errorcode为200。

<友情连结> 手机版 诚博国际 齐乐老虎机 365体育备用网址