智慧服务,成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 客户端SDK参考 > Android UI SDK > 快速入门 快速入门

入门使用

快速入门

更新时间:2019-11-20

本文面向有一定Android原生开发能力的开发者,以登录企业通信云服务器并发起和加入视频会议的流程为例,介绍如何使用SDK 进行二次开发。

开发环境准备

在接入SDK前需要准备如下环境:

表1 环境要求(强制要求)

名称

要求

JDK版本

>1.8.0

Android系统版本

>= Android 5.0

最小Android API 版本

API 21

CPU架构支持

ARM64、ARMV7

集成工具

Android Studio

会议云服务的用户帐号

帐号可来源于华为公有云。开通方法请参见“开发前准备”。

开发此Demo时的开发环境,目的是为了给编译运行源码的人员提供参考。

表2 环境要求(非强制要求)

名称

要求

Android Studio版本

3.2.1

JRE

build 1.8.0_181-b13

minSdkVersion

21

gradle version

gradle-4.6-all

compileSdkVersion

28

targetSdkVersion

26

gradle plugin version

com.android.tools.build:gradle:3.2.1

buildToolsVersion

28.0.3

SDK快速集成

  1. 下载解压 “CloudLinkMeeting_Android_SDK.zip”“CloudLinkMeeting_Android_Demo.zip”软件包,得到如下几个文件。

     

    图1 文件目录 

     

  2. 新建工程。

     

    1. 打开Android Sudio,单击File -> New -> New Project...新建工程,填写工程信息。
      图2 新建工程 
    2. 单击“Next”
    3. 选择“Phone and Tablet”,单击“Next”
      图3 选择“Phone and Tablet” 
    4. 选择“Empty Activity”工程模板,单击“Next”
      图4 选择工程模板 
    5. 输入“Activity Name”,单击“Next”
      图5 输入信息 
    6. 等待下载完成,单击“Finish”完成工程创建。

     

  3. 导入SDK。

     

    1. 在工程APP中,选择New -> Module,新建Module。
      图6 新建Module 
    2. 选择“import .JAR/.AAR Package”,单击“Next”
      图7 选择Package 
    3. 单击“...”,选择步骤1下载到的cloudlinkmeeting.aar,单击“OK”
      图8 导入cloudlinkmeeting.aar 
    4. 单击“Finish”
    5. 重复以上步骤,分别导入CordovaLib-release.aar 和 plugins.aar。

     

  4. 添加依赖。

     

    1. 单击File -> Project Sturcture

    2. 选择app -> Dependencies -> + -> Module dependencies

    3. 选择cloudlinkmeeting,CordovaLib-release和plugins,单击“OK”

     

  5. 添加三方依赖。

     

    SDK依赖了一些优秀的开源库,需要在gradle中添加对这些库的依赖,用如下方式添加。

    1. 在root工程的build.gradle 文件中的allprojects标签下,添加huawei maven 仓库。
      maven { url 'http://developer.huawei.com/repo/' } 
      
       

      添加后的效果如图。

    2. 在app Module 下的build.gradle 的dependencies中添加如下依赖。
      implementation 'com.huawei.android.hms:push:2.5.2.300'
      implementation 'com.google.zxing:core:3.3.0'
      implementation 'com.android.support:appcompat-v7:28.0.0'
      implementation 'com.android.support:support-v13:28.0.0' 
      implementation "com.tencent.mm.opensdk:wechat-sdk-android-without-mta:1.4.0"
      implementation "com.github.bumptech.glide:glide:3.8.0"
      implementation "pub.devrel:easypermissions:2.0.0"
      
       

      添加后的效果如下图所示。

     

  6. 编写demo。

     

    步骤1中的CloudLinkMeeting_Android_Demo中拷贝DemoActivity中的代码和res文件夹的资源到自己新建的工程中,或者自己写好页面的代码,调用SDK提供的接口,实现登录,创建会议,加入会议等逻辑。

    SDK提供的接口如下:

    // 初始化 ,该接口已经废弃,请使用下面的初始化接口
    void clmInit(@NonNull Application application, Context context, CLMCompleteHandler callback);
    //初始化
    void clmInit(@NonNull Application application, Context context, @NonNull String appId, CLMCompleteHandler callback,CLMNotifyHandler notify, CLMConfig config);
    //登录
    void clmLogin(@NonNull String account, @NonNull String password, CLMCompleteHandler handler);
    //创建会议
    void clmCreateMeeting(@NonNull String meetingSubject, int meetingType, boolean needPassword, CLMCompleteHandler handler);
    //加入会议
    void clmJoinMeetingById(@NonNull String meetingID, String accessCode, String nickName, CLMCompleteHandler handler);
    //携带与会者创建会议
    void clmCreateMeetingWithMembers(@NonNull String meetingSubject, int meetingType, boolean needPassword, Set<CLMParticipant> members, CLMCompleteHandler handler);
    //SSO登录
    void clmSSOLogin(@NonNull String domain, @NonNull String userTicket, CLMCompleteHandler handler);
    //注销
    void clmLogout(@NonNull CLMCompleteHandler handler);
    
     

     

  7. 接口调用示例。

     

    • 初始化接口(必须首先调用)
      CloudLinkSDK.getOpenApi().clmInit(getActivity().getApplication(), getContext(), "openSDKDemo" ,completeHandler, notifyHandler, config);
      
       
    • 登录接口
      CloudLinkSDK.getOpenApi().clmLogin(account,password,completeHandler);
      
       
    • 创会接口
      CloudLinkSDK.getOpenApi().clmCreateMeeting(subject,type,needPassword,completeHandler);
      
       
    • 入会接口
      CloudLinkSDK.getOpenApi().clmJoinMeetingById(mId,passCode,nickname,completeHandler);
       
    • SSO登录接口
      CloudLinkSDK.getOpenApi().clmSSOLogin(domain,userTicket,completeHandler);
      
       
    • 注销接口
      CloudLinkSDK.getOpenApi().clmLogout(completeHandler);
      
       

    完成上述调用步骤,就可以运行 Android SDK的demo工程。