[隐藏]

目录

  • 1、API介绍

    帮会API是4399原创平台为游戏开发者提供的一种在游戏内创建玩家帮会的服务,该服务基于玩家游戏存档实现。开发者在接入帮会API后可以在游戏中方便快捷的建立帮会系统,添加帮会活动和任务。开通帮会API,在游戏中加入帮会系统可以极大增强玩家之间的交流,增加游戏趣味性,让玩家有更多的归属感和团队感,有效提高游戏的活跃和粘性。

  • 2、使用案例

  • 3、添加步骤

    3.1.由于帮会系统需使用物品购买功能,所以添加帮会API的游戏需要先开通商城API。

    3.2.使用帮会API前需先联系原创平台申请开通相关接口,申请开通请联系原创平台技术支持QQ 100584399。

    3.3.相关代码

    3.3.1.下载unit4399.rar包,并解压到你游戏代码的根目录

    3.3.2.在游戏主类中加入如下代码:

    //======此代码为帮会API专用代码========/
    var _4399_function_union_id:String = '7c7a741b186b91e2975006321918345f';
    //======此代码为api通用代码,在所有api里面只需加一次========/
    public static var serviceHold:* = null;
    public function setHold(hold:*):void{
        serviceHold = hold;
    }

    3.3.3.接口介绍:

    创建帮会

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    title:必填,为帮会名称
    extra:必填,为帮主自身扩展信息
    */
    serviceHold.unionCreate(idx:int,title:String,extra:String);

    获取帮会列表

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    pageNum:必填,第几页
    pageSize:必填,每页条数
    */
    serviceHold.getUnionList(idx:int,pageNum:int,pageSize:int);

    帮会申请

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    unionId:必填,帮会id
    extra:必填,申请人扩展信息
    */
    serviceHold.applyUnion(idx:int,unionId:int,extra:String);

    获取当前用户所属帮会

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    */
    serviceHold.getOwnUnion(idx:int);

    获取帮会成员列表

    /**
     参数说明:
     idx:必填,为当前用户存档索引,范围0-7
     unionId:必填,帮会ID
     */
    serviceHold.getUnionMembers(idx:int,unionId:int);

    成员扩展信息变更

    /**
    参数说明:
    idx:必填,自己的存档索引
    type:必填,为 1:修改自己的扩展信息 ,非1:修改指定用户的扩展信息
    extra:必填,扩展信息
    以下参数,当type不为1时必填
    unionId:为帮会id,
    userId:为用户id
    userIndex:为用户存档索引
    */
    serviceHold.setMemberExtra(idx:int,type:int,extra:String,unionId:int=0,userId:int=0,userIndex:int=0);

    帮会扩展信息变更

    /**
    参数说明:
    idx:必填,自己的存档索引
    type:必填, 1:帮主修改帮会扩展信息, 非1:成员修改帮会扩展信息
    extra:必填,扩展信息
    unionId:必填,变更当前帮会,unionId可以为0
    */
    serviceHold.setUnionExtra(idx:int,type:int,extra:String,unionId:int);

    获取帮会行为记录列表

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    pageNum:必填,第几页
    pageSize:必填,每页条数
    */
    serviceHold.getUnionLog(idx:int,pageNum:int,pageSize:int);

    退出帮会

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    */
    serviceHold.quitUion(idx:int);

    消耗个人贡献点

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    contribution:必填,需要消耗的贡献点数
    */
    serviceHold.usePersonalContribution(idx:int, contribution:int);

    帮会任务

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    task:必填,为任务ID
    */
    serviceHold.doTask(idx:int,task:String);

    游戏币兑换贡献值

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    money:必填,为游戏币
    */
    serviceHold.doExchange(idx:int,money:int);

    获取任务完成情况

    /**
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    */
    serviceHold.getTaskValue(idx:int);

    获取待审核列表

    /**    
    参数说明:     
    idx:必填,为当前用户存档索引,范围0-7
    pageNum:必填,第几页
    pageSize:必填,每页条数
    */
    serviceHold.getApplyList(idx:int,pageNum:int,pageSize:int);

    成员审核

    /**    
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    userId:必填,被审核用户id
    userIndex:必填,被审核用户存档索引
    auditResult:必填,审核结果:(0:拒绝,1:通过)
    */
    serviceHold.auditMember(idx:int,userId:int,userIndex:int,auditResult:int);

    多成员审核

    /**    
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    usersAry:必填,为多成员数组,其中包含的数据对象如下:
        obj.uid 为成员id
        obj.index  为成员索引
     
    auditResult:必填,审核结果:(0:拒绝,1:通过)
    */
    serviceHold.applyMultiAudit(idx:int,usersAry:Array,auditResult:int);

    移除成员

    /**    
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    userId:必填,被移除用户id
    userIndex:必填,被移除用户存档索引
    */
    serviceHold.removeMember(idx:int,userId:int,userIndex:int);

    消耗帮会贡献点

    /**    
    参数说明:     
    idx:必填,为当前用户存档索引,范围0-7
    contribution:必填,为要消耗的帮会贡献点数
    */
    serviceHold.useUnionContribution(idx:int,contribution:int);

    解散帮会

    /**    
    参数说明:     
    idx:必填,为当前用户存档索引,范围0-7
    actionType:必填, 0:取消解散, 1:解散
    解散72小时后生效
    */
    serviceHold.dissolveUnion(idx:int,actionType:int);

    转让帮会

    /**    
    参数说明:     
    idx:必填,为当前用户存档索引,范围0-7
    userId:必填, 为要转让给的用户id
    userIndex:必填, 为要转让给的用户存档索引
    result:必填,是否转让标识,0:取消转让 1:确定转让
    */
    serviceHold.transferUnion(idx:int,userId:int,userIndex:int,result:int);

    获取公共变量的值

    /**    
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    ids:必填, 公共变量id
    */
    serviceHold.getVariables(idx:int,ids:Array);

    改变公共变量的值

    /**    
    参数说明:     
    idx:必填,为当前用户存档索引,范围0-7
    id:必填, 要改变公共变量的id
    */
    serviceHold.doVariable(idx:int,id:int);

    获取游戏帮会设置的角色权限列表

    /**   
    参数说明:
    pageNum:必填,为第几页
    pageSize:必填,为每页条数
    */
    serviceHold.getRoleList(pageNum:int, pageSize:int);

    设置某个用户存档在帮会中的角色权限

    /**   
    参数说明:
    idx:必填,为当前用户存档索引,范围0-7
    uid:必填,为被设置的用户的ID编号
    index:必填,为被设置的用户的存档索引,范围0-7
    roleId:必填,被设置成为的角色权限编号;如果roleId为0,则是取消角色
    */
    serviceHold.setRole(idx:int, uid:int, index:int, roleId:int);

    3.3.4.接口返回处理:

    步骤一:

    import unit4399.events.UnionEvent;

    步骤二:

    在构造函数体中,添加如下代码:

    stage.addEventListener(UnionEvent.UNION_VISITOR_SUCCESS, onVisitorSuccess);
    stage.addEventListener(UnionEvent.UNION_MEMBER_SUCCESS, onMemberSuccess);
    stage.addEventListener(UnionEvent.UNION_GROW_SUCCESS, onGrowSuccess);
    stage.addEventListener(UnionEvent.UNION_MASTER_SUCCESS, onMasterSuccess);
    stage.addEventListener(UnionEvent.UNION_VARIABLES_SUCCESS, onVariablesSuccess);
    stage.addEventListener(UnionEvent.UNION_ROLE_SUCCESS, unionRoleSuccess);
    stage.addEventListener(UnionEvent.UNION_ERROR, unionCreateError);

    步骤三:

    声明新的函数,代码如下:

    /*游客模块返回信息处理*/ 
    function onVisitorSuccess(e:UnionEvent)
    {
        var dataObj:Object = e.data;
        resultTxt.appendText("apiName:"+dataObj.apiName+"\n");
          
        var data:* = dataObj.data;
        switch(dataObj.apiName)
        {
            case UnionEvent.UNI_API_BHCJ: /*帮会创建*/
                   /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */  
                resultTxt.appendText("帮会创建结果:\n"+Boolean(data)+"\n");
            break;
            case UnionEvent.UNI_API_BHLB: /*获取帮会列表*/
                /*返回结果为json格式:
                    unionList:为json对象数组
                        属性unionId:帮会id
                        属性title:名称
                        属性username:帮主名称
                        属性level:等级
                        属性count:人数
           属性extra:帮会扩展信息
           属性experience:经验            
                    rowcount:为帮会总记录数
                 例如:
                {"unionList":[{"extra":"","username":"yjtest","level":1,"count":"1","unionId":4,"title":"妖精尾巴","experience":3}],"rowCount":3}           
                */
                 resultTxt.appendText("帮会列表:\n"+String(data)+"\n");
            break;
            case UnionEvent.UNI_API_BHSQ: /*申请加入帮会*/
               //返回的结果为Boolean类型,true为成功,false为失败
                 resultTxt.appendText("帮会申请结果:\n"+Boolean(data)+"\n");
            break;
            case UnionEvent.UNI_API_SSBH: //当前成员所属帮会
            /*返回结果为json格式:
             unionInfo:帮会信息
                   属性id:帮会id
                   属性gameId:游戏ID
                   属性uId:用户ID(帮主)
                   属性username:帮主名称(帮主)
                   属性index:存档索引(帮主)
                   属性title:帮会名称
                   属性level:等级
                   属性experience:经验
                   属性contribution:贡献
                   属性extra:帮会扩展(权限:帮主)
                   属性extra2:帮会扩展(权限:成员)
         属性dissolveDate:帮会解散日期
         属性count:人数
         属性transfer:帮派转让日期,格式:uid_userIndex_timestamp :"284577429_0_1393901345" ,没有返回0
             member:成员
                   属性gameId:游戏ID
                   属性unionId:帮会ID
                   属性uId:用户ID(自己)
                   属性userName:用户名(自己)
                   属性index:存档索引(自己)
                   属性nickName:昵称(自己)
                   属性contribution:贡献
                   属性extra:扩展信息(权限:自己)
                   属性extra2:扩展信息(权限:成员)
                   属性active_time:活跃时间
                   属性rodId:角色ID
                   属性roleName:角色名称
              例如:
              {"unionInfo":{"uId":"591530049","gameId":100028963,"count":"1","level":4,"dissolveDate":"0",
              "experience":47,"id":10,"contribution":47,"extra":"","extra2":"","userName":"ciananji",
              "title":"test3","nickName":"pppp000.3","index":"0","transfer":"0"},
              "member":{"unionId":10,"uId":"591530049","gameId":100028963,"extra":"4444",
              "contribution":0,"extra2":"","active_time":null,"userName":"ciananji","nickName":"pppp000.3","index":"0",
              "roleId":1, "roleName":"测试角色"}}
                */
             resultTxt.appendText("当前用户所属帮会信息:\n"+String(data)+"\n");
            break;
        }
         
    }
    /*成员模块返回信息处理*/
    function onMemberSuccess(e:UnionEvent)
    {
        var dataObj:Object = e.data;
        resultTxt.appendText("apiName:"+dataObj.apiName+"\n");
    
        var data:* = dataObj.data;
        switch(dataObj.apiName)
        {
            case UnionEvent.UNI_API_BHMX: /*帮会详情*/
                /*返回结果为json对象格式:
                        属性id:帮会id
                        属性gameId:游戏ID
                        属性uId:用户ID(帮主)
                        属性username:帮主名称(帮主)
                        属性index:存档索引(帮主)
                        属性title:帮会名称
                        属性level:等级
                        属性experience:经验
                        属性contribution:贡献
                        属性extra:帮会扩展(权限:帮主)
                        属性extra2:帮会扩展(权限:成员)
                        属性dissolveDate:帮会解散日期
           属性count:人数
           属性transfer:帮派转让日期,格式:uid_userIndex_timestamp :"284577429_0_1393901345" ,没有返回0
                  例如:
                 {"uId":"591530049","gameId":100028963,"count":"1","level":4,"dissolveDate":"0","experience":47,"id":10,"contribution":47,"extra":"","extra2":"",
                 "userName":"ciananji","title":"test3","nickName":"pppp000.3","index":"0","transfer":"0"}
                */
                resultTxt.appendText("帮会明细结果:\n"+String(data)+"\n");
            break;
            case UnionEvent.UNI_API_BHCY: /*帮会成员列表*/
                /*返回结果为json数组对象格式:
                  属性gameId:游戏ID
                  属性unionId:帮会ID
                  属性uId:用户ID
                  属性userName:用户名
                  属性index:存档索引
                  属性nickName:昵称
                  属性contribution:贡献
                  属性extra:扩展信息(权限:自己)
                  属性extra2:扩展信息(权限:成员)
                  属性active_time:活跃时间
                  属性roleId:角色ID
                  属性roleName:角色名称
                  例如:
                  [{"contribution":0,"unionId":4,"extra":"4233","extra2":"","userName":"yjtest","gameId":100026221,
                  "uId":"537586565","nickName":"","index":"0","active_time":"1387772690", "roleId":1, "roleName":"测试角色"}]
                */
                resultTxt.appendText("帮会成员列表:\n"+String(data)+"\n");
            break;
            case UnionEvent.UNI_API_CYTZBG: /*成员扩展信息变更*/
               /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */
                 resultTxt.appendText("成员扩展信息变更:\n"+Boolean(data)+"\n");
            break;
            case UnionEvent.UNI_API_BHTZBG: /*帮会扩展信息变更*/
               /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */
             resultTxt.appendText("帮会扩展信息变更:\n"+Boolean(data)+"\n");
            break;
            case UnionEvent.UNI_API_BHRZ: /*帮会行为记录列表*/
             /*
              返回结果为json对象格式
              logList:为日志列表,json数组对象格式
                  type:日志类型,不同日志类型返回的数据格式有所不同,
                  type类型如下:
                       创建帮会:createUnion
                       加入帮会:joinUnion
                       退出帮会:exitUnion
                       任务日志:task
                       兑换:exchange
                       解散帮会:disUnion
                       取消解散帮会:unDisUnion
                  username:用户名称
                  time:时间戳格式,为日志时间
                  title:帮会名称(当type为"createUnion"时,有此属性)
                  taskId:任务ID(当type为"task"时,有此属性)
                  money:游戏币(当type为"exchange"时,有此属性)
                  contribution:贡献(当type为"task","exchange"时,有此属性)
                  disTime:解散帮会时间(当type为"disUnion"时,有此属性)
              例如:
              {"logList":[
             {"type":"createUnion","username":"yjtest","time":1387772690,"title":"妖精尾巴"},
              {"time":1387772690,"username":"yjtest","type":"joinUnion"}],
              "rowCount":2}
              */
             resultTxt.appendText("帮会行为记录列表:\n"+String(data)+"\n");
            break;
            case UnionEvent.UNI_API_TCBH: /*退出帮会*/
             /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */
             resultTxt.appendText("退出帮会信息:\n"+Boolean(data)+"\n");
            break;
            case UnionEvent.UNI_API_XHGRGXD: /*消耗个人贡献点*/
                /*返回的结果为int类型,剩余贡献点*/
                resultTxt.appendText("消耗个人贡献点信息:\n"+int(data)+"\n");
    		break;
            case UnionEvent.UNI_API_SZJS:/*设置角色权限*/
                /*返回的结果为Boolean类型,
                  true为成功,
                  false为失败
                */
                resultTxt.appendText("设置角色权限信息:\n" + Boolean(data) + "\n");
            break;
        }
    }
    /*帮会成长模块返回信息处理*/   
    function onGrowSuccess(e:UnionEvent)
    {
        var dataObj:Object = e.data;
        resultTxt.appendText("apiName:"+dataObj.apiName+"\n");
          
        var data:* = dataObj.data;
        switch(dataObj.apiName)
        {
            case UnionEvent.UNI_API_BHRW: /*帮会任务*/
                /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */
                resultTxt.appendText("帮会任务结果:\n"+Boolean(data)+"\n");
            break;
            case UnionEvent.UNI_API_BHDH: /*帮会兑换*/
               /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */
                resultTxt.appendText("帮会兑换信息:\n"+Boolean(data)+"\n");
            break;
            case UnionEvent.UNI_API_BHRWWC: /*帮会任务完成情况*/
               /*
                返回结果为json格式
                属性tasklist:任务列表,为json数组对象格式
                属性taskName:为任务ID
                属性value:任务值
                属性exchange:兑换值
                属性total:总的任务值
                例如:
                {"exchange":"1","tasklist":[{"value":"70","taskName":"14"}],"total":"71"}
                */
                 resultTxt.appendText("帮会任务完成情况:\n"+String(data)+"\n");
            break;     
         }
    }
    /*帮主模块返回信息处理*/ 
    function onMasterSuccess(e:UnionEvent)
    {
        var dataObj:Object = e.data;
        resultTxt.appendText("apiName:"+dataObj.apiName+"\n");
          
        var data:* = dataObj.data;
        switch(dataObj.apiName)
        {
            case UnionEvent.UNI_API_DSHLB: /*待审核列表*/
                /*
                 返回结果为json对象格式:
                     属性applyList:为待审核列表,json数组对象格式
                         gameId:游戏ID
                         unionId:帮会ID
                         uId:用户ID
                         userName:用户名
                         index:存档索引(用户存档ID)
                         nickName:昵称
                         extra:扩展信息(用户扩展信息)
                      属性rowCount:为总记录数
                          
                 {"applyList":[{"extra":"哈哈哈","userName":"yjtest5","gameId":100026221,"unionId":4,"uId":"537593226",
                 "nickName":"屋顶123","index":"0"}],
                 "rowCount":1}
                 */
                resultTxt.appendText("待审核列表:\n"+String(data)+"\n");
            break;
            case UnionEvent.UNI_API_CYSH: /*成员审核*/
               /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */
                resultTxt.appendText("成员审核信息:\n"+Boolean(data)+"\n");
            break;
            
            case UnionEvent.UNI_API_CYYC:/*移除成员信息*/    
             /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */    
                 resultTxt.appendText("移除成员信息:\n"+Boolean(data)+"\n");
            break;     
            case UnionEvent.UNI_API_JSBH:/*解散帮会信息*/
                 /*
                  返回结果为String类型:
                  返回帮会解散的时间
                  例如:    2013-12-23 14:57:57
                  */
                 resultTxt.appendText("解散帮会信息:\n"+String(data)+"\n");
            break; 
            case UnionEvent.UNI_API_XHBHGXD:/*消耗帮会贡献点*/
    		     /*返回结果为int类型,剩余贡献点*/
    		     resultTxt.appendText("消耗帮会贡献点信息:\n"+int(data)+"\n");
    			 break;
    		case UnionEvent.UNI_API_SHDGCY:/*审核多个成员*/
    		      /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */    
    		     resultTxt.appendText("审核多成员信息:\n"+Boolean(data)+"\n");
    			 break;
    	    case UnionEvent.UNI_API_ZRBH: /*转让帮会*/
    		     /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */    
    		     resultTxt.appendText("转让帮会信息:\n"+Boolean(data)+"\n");
    		     break;	
         }
    }
    /*公共变量模块返回信息处理*/   
    function onVariablesSuccess(e:UnionEvent)
    {
        var dataObj:Object = e.data;
        resultTxt.appendText("apiName:"+dataObj.apiName+"\n");
          
        var data:* = dataObj.data;
        switch(dataObj.apiName)
        {
            case UnionEvent.UNI_API_HQBL: /*获取公共变量数据*/
                /*
                 返回json数组对象:
                     属性id:公共变量id
                     属性value:公共变量值
                 例如:
                 [{"id":"23","value":"100"},{"id":"24","value":"4"}]
                 */
                resultTxt.appendText("公共变量列表:\n"+String(data)+"\n");
            break;
            case UnionEvent.UNI_API_XGBL: /*修改公共变量值*/
                 /*返回的结果为Boolean类型,
                true为成功,
                false为失败
               */  
                resultTxt.appendText("公共变量修改信息:\n"+Boolean(data)+"\n");
            break;     
         }
    }
    /*角色模块返回信息处理*/
    private function unionRoleSuccess(e:UnionEvent):void
    {
        var dataObj:Object = e.data;
        resultTxt.appendText("apiName:" + dataObj.apiName + "\n");
        var data:* = dataObj.data;
        switch (dataObj.apiName)
        {
            case UnionEvent.UNI_API_JSQXLB: /*角色权限列表*/
                /*
                返回结果为json对象格式:
                属性roleList:为角色权限列表,json数组对象格式
                name:该角色的权限名称,分别有添加、踢出、发布、任命,以“、”号分隔
                memo:备注
                id:该角色权限的编号
                privilegeList:该角色权限的英文名称,分别有ApplyAudit、MemberRemove、SetUnionExtra、SetRole,以“|”号分隔
                create_time:创建时间
                属性rowCount:为总记录数
                例如:
                {"roleList":[{"name":"修改、任命、踢出","memo":"3","id":108,"privilegeList":"MemberRemove|SetUnionExtra|SetRole","create_time":1415777568},{"name":"添加、踢出、发布、任命","memo":"4","id":102,"privilegeList":"ApplyAudit|MemberRemove|SetUnionExtra|SetRole","create_time":1415608960}],"rowCount":2}*/
                resultTxt.appendText("角色权限列表:\n" + String(data) + "\n");
            break;
        }
    }
    /*帮会错误返回信息处理*/
    function unionCreateError(e:UnionEvent)
    {
        /*
         异常列表:
         eId  : message
         10002:参数错误
         10003:游戏未开通帮会API
         10004:只有帮主有权限
         10005:用户未登陆
         20001:用户没有钱
         20002:余额不足
         20003:扣款失败
         20004:帮会名称已存在
         20005:一个用户的一个存档,只能建一个帮派
         20006:超过申请数量上限
         20007:该帮会的申请列表已满
         20008:用户已经有帮会了
         20009:已经申请过了
         20010:用户还没有加入任何帮会
         20011:不存在该帮会
         20012:移除成员失败,用户不属于该帮会
         20013:移除成员失败,帮主不能被移除
         20014:审核失败,帮会成员已满
         20015:编辑extra失败,只有帮主有该权限
         20016:超过最大贡献值
         20017:不存在该公共变量
         20018:超过最大数量
         20019:extra的字符数超过最大个数限制(1500)
         20020:退出帮会后,24小时内不能申请加帮会
         20021:没有兑换配置
         20022:用户的申请信息已经过期
         20023:帮会id错误
         20024:已经申请过解散帮会了
         20025:没有该任务
         20026:用户不在审核列表中
         20027:只有在加入帮会的24小时后才能进行贡献
         20028:没有解散过帮会,不能进行取消解散
         20029:公共变量未到生效时间
         20030:账号不能变换存档加入同一个帮会。
         20031:贡献点不足
         20032:用户不在该帮会中
         20033:不能转让给自己
         20034:不存在的转让
         20035:转让已存在
         20036:解散状态不能转让
         20037:转让状态不能解散
         20038:未过24小时时间限制
         20039:移除员失败,自己不能被移除
         30001:数据库添加失败
         30002:数据库删除失败
         40001:特殊用户的type填写错误
         40002:没有这个用户
         60001:角色不存在
         60002:角色没有足够的权限
         */
        resultTxt.appendText("eId:" + e.data.eId + "  message:" + e.data.msg + "\n");
    }

  • 4、常见问题解答

    4.1.添加帮会API有什么好处?

    游戏帮会是指游戏内一定数量的玩家组成的一个小团体,游戏帮会可以为玩家提供一个交流,互助,合作,共赢的平台。加入帮会的玩家可承接各种帮会任务,参与帮会战斗,建设帮会建筑,获得帮会荣誉。开通帮会API,在游戏中加入帮会系统可以极大增强玩家之间的交流,增加游戏趣味性,让玩家有更多的归属感和团队感,有效提高游戏的活跃和粘性。

    4.2.开发者在哪里配置帮会相关设置?

    帮会API提供了专门用于帮会管理的面板,能够创建帮会,添加和编辑帮会任务、公共变量和帮会创建白名单,并能实时同步到客户端游戏帮会中。

    开通帮会功能并添加帮会API代码后,开发者可在 [游戏列表]->[游戏管理]->[帮会API] 的各个子菜单中管理帮会。

    4.3.如何在游戏中配置帮会系统?

    开通帮会API后,在[游戏列表]->[游戏管理]->[ API设置] ->[帮会API]->[创建帮会设置]中配置帮会的基本属性。

    首先需要填写创建帮会所需要的游戏币(通过人民币兑换的游戏币)和帮会升级所需要的经验,当前帮会最高等级为50级。

    4.4.如何配置帮会任务?

    开通帮会API后,在[游戏列表]->[游戏管理]->[ API设置] ->[帮会API]->[帮会任务设置]中可配置帮会任务。

    4.5.如何配置帮会API公共变量?

    公共变量是指帮会中所有玩家可以共同参与的任务,可以设置递增和递减两种类型的公共变量。

    开通帮会API后,在[游戏列表]->[游戏管理]->[ API设置] ->[帮会API]->[公共变量设置]中可设置配置公共变量。

    4.6.如何添加帮会API白名单?

    帮会白名单是一个玩家ID列表,加入该列表的玩家在创建帮会时无需使用游戏币,方便开发者作为活动奖励玩家和进行测试工作。

    开通帮会API后,在[游戏列表]->[游戏管理]->[ API设置] ->[帮会API]->[白名单设置]中配置白名单。

    4.7.帮会沙盒模式与正式模式的区别?

    为了帮助开发者能够方便的进行游戏中帮会相关的测试,帮会API中设定了沙盒模式与正式模式。

    帮会管理正式模式中配置的数据将作用于线上运行的游戏数据,帮会管理沙盒模式中配置的数据仅作用于沙盒模式,线上模式不可见。具体见下图说明