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

主页 > 服务与支持 > 开发平台 > 客户端SDK参考 > Web SDK > 组件初始化 组件初始化

入门使用

组件初始化

更新时间:2019-11-19

描述

在使用SDK业务组件时,需要先完成SDK的基础组件的初始化。

业务流程

图1 初始化流程图 
  1. 构建数据结构options。
  2. 调用cloudEC.configure()接口,完成配置初始化,第1步中的options作为参数。
    代码示例:
    "use strict";
    (function(root) {
        var options = {
            domain: "localhost.cloudec.huaweicloud.com",
            isWSS: 1,
            confCtrlProtocol: 1,
            isTlsSupport: 0,
            uiPluginAppDisplayName : "eSDK-Desktop",
            IsSupportSvcConference:1,
    
            uiPluginlLanguage : 0,
            uiPluginResourcesPath: "",
            uiPluginUserFilesPath:"",
            uiPluginHasFrameInfo:0,
            uiPluginFrameInfoX:0,
            uiPluginFrameInfoY:0,
            uiPluginFrameInfoWidth:1280,
            uiPluginFrameInfoHeight:720,
            uiPluginHasParentInfo:0,
            uiPluginParentInfoIsNeedAttach:0,
            uiPluginParentInfoXOffsetRate:0,
            uiPluginParentInfoYOffsetRate:0,
    
            uiPluginHideTopToolBar:0,
            uiPluginHideBottomToolBar:0,
            uiPluginHideInviteButton:1,
            uiPluginHideAttendeesButton:1,
            uiPluginHideShareButton:1,
            uiPluginDataHideInviteButton:1,
            uiPluginDataHideAttendeesButton:1,
            uiPluginDataHideRequestRemotecontrolButton:1,
        }
        cloudEC.configure(options);
    
    })(this);
    
     

    参考文件:\usage\config.js。

  3. 构建数据结构listeners,为关心的事件添加回调函数。
  4. 调用cloudEC.createClient()接口,完成client对象创建,第3步中的listeners作为参数。

    代码示例:

    "use strict";
    (function (root) {
        var listeners = {
            onForceUnReg: (ret) => {
                alert("you have be kickouted")
                document.getElementById("login").style.display = "block";
                document.getElementById("main").style.display = "none";
            },
            onConfIncoming: (ret) => {
                let con_ret = confirm("you have a incoming conference, accept?");
                if (con_ret === true) {
                    ret.info.answerConference(true)
                } else {
                    ret.info.answerConference(false)
                }
            },
            onConfConnected: (ret) => {
                alert("the conference is connected")
            },
            onError: (ret) => {
                alert("wowo,error is coming!" + ret)
            },
        }
        root.client = cloudEC.createClient(listeners);
    })(this);
    
     

    参考文件:\usage\event_process.js。

注意事项

  1. 第1、2步可选,如不进行配置,则采用默认配置。
  2. 第3步中,必须对onError事件添加回调函数,否则可能无法收到必要的错误通知。
  3. 若需要使用“多流会议”能力,在调用configure()接口完成配置初始化时,则需要设置"IsSupportSvcConference"字段值为 1。此能力推荐使用,以便给最终用户提供更优的会议体验。