创建微哨轻应用

1.登录微哨开放平台

微哨开放平台暂不开放注册，可通过微哨客户端点击菜单进入，点击下图中红色框中的按钮即可打开开放平台。

2.下载SDK（开发示例）代码：

点击菜单后打开页面如下：

下载PHP-SDK，并解压，得到如下文件：

打开weishao_lightapp\sdk\微哨PHP-SDK\文件夹下的index.php，进行编辑。找到如下字段（MyWhistlechat）：

 将/*轻应用通讯凭证*/替换为一串字母和数字的字符串，内容自定，该轻应用通讯凭证会在创建微哨应用时用到。本例中轻应用通讯凭证定为“123456”，修改后如下： 

注意要用英文符号。

将代码部署至自己的服务器(没有服务器的用户可以尝试申请sae、bae免费服务器资源)。

注：代码部署后，请注意访问链接，该链接会在创建微哨轻应用时用到。本文假设该链接地址为：http://whistleapp.example.com/

注：1、文件编码一定要是UTF8格式(非UTF8 BOM)！如果在Windows操作系统下编辑，请选择editplus等专业编辑器，切勿使用windows自带的文本编辑器进行编辑。

2、本代码封装了消息格式，服务校验，消息发送等功能，有兴趣的用户可以阅读一下，并根据自己的需要进行更改和扩展。

3.创建应用

点击下图中红色方框中的“进入我的个人中心”

打开如下界面：

点击“添加新应用”，打开如下页面：

根据自己的需要填写相关信息。

轻应用通讯凭证：填写SDK代码中更改的“/*轻应用通讯凭证*/”，本文填写的是“123456”。轻应用通讯凭证用于校验微哨服务器消息请求的合法性，校验机制和示例代码可参考《微哨校园开放平台-轻应用开发者文档》中的“消息合法性校验”。

注：要保证在此处填写的内容和代码中填写的一致。

轻应用通讯URL：是能是够访问到的微哨轻应用代码所在服务器的URL（即上一步中部署的微哨轻应用代码所在的服务器链接，本文以http://whistleapp.sinaapp.com为例）。填写URL，并通过验证（校验代码已经写入SDK中），就可点击“保存并继续”，打开如下界面:

 

 

根据提示上传相应的图片和图标。点击“保存并继续”打开如下界面：

其中Appid、AppSecret是调用微哨开放接口的凭据，以此来获取access_token。应用创建后，需要一名老师和9名学生同意你的应用之后才能开放。不过在开放前，你也可以点击“复制地址”复制应用链接，发送给老师和同学让他们试用，老师和同学同意后就可以开放应用（注：老师和同学必须是自己的好友）。开放后用户就可以在客户端的应用仓库中找到该应用了。

点击“完成”，如下：

至此新应用已添加完成。

接下来设置应用菜单 

点击对应应用的设置菜单按钮

 

 

 

打开如下窗口：

点击“出现菜单示例”会显示如下代码：

 

代码格式为json，具体菜单的详细说明可以参考开发文档部分菜单设置相关说明，在本例中您可以直接确定。

4.测试微哨轻应用 

如果要测试开发的微哨轻应用，可以点击“我的应用”，应用列表中对应应用的名称

 

 会显示如下界面：

 点击“点击复制地址”，复制应用链接，粘贴至微哨的任意聊天会话窗口，会显示如下界面：

 

点击“帮忙测试”会打开新的应用窗口

 

至此，开发者就可以测试自己的应用了。

 

5.关于微信公众号向微哨开放平台的迁移

为了降低已开发微信公众号的用户进行新应用开发的难度，微哨开放平台轻应用的开发接口都最大程度的保持了与与微信开放公众号的一致性。用于微信公众号的代码，只需做少许升级即可适用于微信公众账号，下面列出两者的不同。

 

不同项	微哨	微信
消息格式	微哨轻应用没有订阅机制，但是有hello报文协议，当用户打开应用时会发送一条hello报文，开发者可根据需要回复内容。
获取access_token的URL	https:// 校园微哨通讯服务器/cgi-bin/oauth2/ access_token?grant_type=client_credentials&client_id=APPID&client_secret= APPSECRET	https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
菜单 操作	设置菜单 https:// 校园微哨通讯服务器?m=menu&a=setMenu& app_id=APPID&token=ACCESS_TOKEN 查询菜单 https:// 校园微哨通讯服务器?m=menu&a=viewMenu &app_id= APPID &token= ACCESS_TOKEN 删除菜单 https:// 校园微哨通讯服务器?m=menu&a=delMenu& app_id= APPID &token= ACCESS_TOKEN	设置菜单 https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN 查询菜单 https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN 删除菜单 https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN
文件 上传	文件上传： http:// 校园微哨资源服务器/ upload?access_token= 3Zkx2gyQVaeIbS   文件下载： http:// 校园微哨资源服务器/ uri	文件上传： http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE 文件下载： http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
其他	所有封装的消息格式中标签名称均为小写字母。

 注：

1.其他未列出项目，均保持了与微信公众平台的统一。整体的业务逻辑也都保持与微信一致，只需替换以上不同的接口即可实现微信公众号向微哨开放平台的迁移。

2.由于微哨服务器是配置在校园内部的，因此校园微哨通讯服务器、校园微哨资源服务器会因学校不同而不同。用户可登陆微哨开放平台获取。登陆开放平台后依次打开，“进入我的个人中心” à“我的应用”à“编辑”，显示如下界面：

 

校园通讯服务器和校园资源服务器的地址会在此处显示。

6.总结

本文主要针对入门级的开发用户，如需要了解更详细的信息，请参考开发文档部分.

注：本文及开发文档的word版本均放置在轻应用SDK示例压缩包，用户可通过下载SDK压缩包获取。