启动百宝云接口教程

第二章：专题解析

        第一节：默认接口 /内置事件

              内置事件一览表

事件名称	事件描述
_initial()	云应用启动的时候将会触发此函数，是云应用的入口函数
_mainbutton(arg)	云应用里面按主按钮的时候，云应用中将会触发此函数
_get(token,arg)	外部执行get请求数据的时候，云应用中将会触发此函数
_post(token,arg)	外部执行post请求数据的时候，云应用中将会触发此函数
_commoninterface(token,arg)	com插件执行commoninterface函数时，云应用中将会触发此函数
_userlogin(token,arg1,arg2,&out_ret)	com插件执行login函数的时候，云应用中将会触发此函数
_userpush(token,arg1,arg2,&out_ret)	com插件执行pushconnect函数的时候，云应用中将会触发此函数
_loadconfig()	云应用请求配置信息的入口函数，将会触发此函数,来加载初始化界面
_submitconfig(id,value)	在云应用里操作交互界面时,将会触发此函数,确定下个要加载的界面
_requestappmsg(token,arg)	在云应用里调用appsendmsg函数时，token指定的云应用触发此事件

 

    1.1 初始化事件 （_initial）

     此事件为云应用的入口函数，启动云应用时，触发此函数。我们可以把一些需要和云应用一起启动的功能写到此事件里。

 

    1.2 主按钮事件（_mainbutton）

     主按钮示意图：

 

     此事件为点击云应用里主按钮触发的函数，点击主按钮也可以启动云应用。

如果在云应用未启动的状态下点击主按钮，云应用会先执行_initial函数，之后再执行_mainbutton函数。如果云应用已经启动了，那么就只执行_mainbutton函数。

 

    1.3 云应用交互事件（_requestappmsg）

      当一个云应用里执行appsendmsg(token,arg)、发送消息给云应用(token,发送消息)函数时，token对应的云应用将触发_requestappmsg函数。

 

     appsendmsg(token,arg)、发送消息给云应用(token,发送消息)函数说明：

     token：目标云应用生成的token值。

     arg/发送消息 ：传递给目标云应用的参数。

 

     事件_requestappmsg(token,arg)中的arg参数对应appsendmsg(token,arg)的arg，也就是说，appsendmsg中arg传递什么内容，那么_requestappmsg中的arg就接收到什么内容。

 

    1.4 举例：

    发送端：

// 程序入口功能
功能 _initial()
结束
// 按下主按钮触发的功能方法
功能 _mainbutton()
    发送文本消息("发送指令给目标云应用")
    测试交互()
结束
 
功能 测试交互()
    变量 ret = 发送消息给云应用("百宝云开发中心云应用项目token","签到")
    发送文本消息("执行结果:"&ret)
结束
 

接收端：

// 程序入口功能
功能 _initial()
    发送文本消息("云应用已经启动")
结束
// 按下主按钮触发的功能方法
功能 _mainbutton()
    
结束
 
功能 _requestappmsg(token,arg)
    如果(arg == "签到")
        返回 "签到成功"
    结束
    
    返回 "未知指令"
结束