UCenter 应用开发简略指南
你有PHP的开发基础?想把自己的程序集成到 UCenter?呵呵,来对了,看看这篇文章再动手吧,我会告诉你如何让自己的程序加入到 UCenter 的大家庭里。
首先,自然是要下载一份UCenter 1.0.0 接口开发手册,而且要随时留意这个手册哦,它会随着 UCenter 版本的升级而更新。
大家拿到了手册后会看到目前 UCenter 所内含的八大类接口函数(用户、短消息、好友、积分、头像、标签、事件、应用)。别看着头大,不一定都集成哦,按需所需,你觉得需要哪些就用哪些。在进行集成前,你需要先按照以下步骤进行一些准备工作:
- 复制一份接口开发手册里面的 client/ 目录到你程序的根目录下。
- 然后复制一份开发手册里面样例程序 examples/ 目录中的 api/ 子目录到你程序的根目录下。
- 如果您的应用程序的根目录有 config.inc.php 文件,在此文件里定义以 UC_ 开头的常量,具体常量内容可以参考手册中“了解 UCenter”章节。
此时,你需要在 UCenter 的“应用管理”->“+添加新应用”选择“自定义安装”,“接口 URL”填写你程序的 URL 地址,通信密钥可随意填写,如“12345”,“应用类型”选择“其他”,然后创建新应用,记录下新应用的 ID 。然后在 config.inc.php 中的 UC_APPID 常量填写新应用的 ID,UC_KEY 填写刚才填写的通信密钥“12345”。这时回到应用管理,如果此时提示此应用“通信成功”,说明您的准备工作已完成。如果你的程序的配置文件不是 config.inc.php 其自行修改代码 api/uc.php 中的内容。
准备工作进行完毕后,首先你需要集成的是用户接口,因为用户接口是集成其他接口的先决条件。
使用以下接口函数你必须同时设计和他相关的 API 的代码,关系如下:
接口函数 | API |
同步登录、同步退出 | synlogin(同步登录)、synlogout(同步退出) |
积分兑换 | getcreditsettings(提供积分参数)、updatecreditsettings(设置积分兑换参数)、updatecredit(更新用户积分) |
标签 | gettag(提供标签数据) |
如果你的程序有自己的用户表,那么需要设计 deleteuser(删除用户)、renameuser(改用户名)、updatepw(更改密码) 三个 API 的代码,用于和用户中心的用户资料进行同步,当然 updatepw 不是必须的,因为集成到 UCenter 后用户的真实密码是保存到 UCenter 的。
如果你的程序需要获取 UCenter 的一些设置数据,那么可以考虑按情况设计 updatebadwords(词语过滤设置)、updatehosts(域名解析设置)、updateapps(应用列表设置)、updateclient(基本设置) 这些 API 的代码。
以上所涉及到 API 代码,如果某些 API 你不打算提供,可以在 api/uc.php 中文件开头的常量中关闭,如你的程序不提供 updatepw(更改密码) 这个 API,那么你需要设置常量 define(‘API_UPDATEPW’, 0);
以上说明了集成到 UCenter 的一些简单的必备的知识,详细的开发过程请仔细参考开发手册,如有疑问欢迎到本版块进行提问,互相交流。来吧,加入 UCenter 这个大家庭。
UCenter 应用开发集成度指标(根据难易程度)
编号: 集成内容 | 难易程度 |
A1: 用户的注册和登录 | 10 |
A2: 同步登录、同步退出登录 | 5 |
A3: 短消息(接口方式或短消息中心方式) | 10 |
A4: 好友信息的同步 | 10 |
A5: 积分兑换 | 15 |
A6: 头像设置、头像的应用 | 5 |
A7: 标签、相关标签聚合 | 15 |
A8: 事件(Feed)接口、给 UCenter Home 提供事件 | 10 |
B1: 旧用户数据的导入和当前用户信息的同步 | 10 |
B2: 提供集成到 UCenter 的安装方法 | 10 |