事件接口

首页 > 资料库 > UCenter相关 > 接口开发标签：阅读：

事件接口

此部分接口负责应用间信息的聚合。

添加事件

integer uc_feed_add(string icon , integer uid , string username , string title_template , string title_data , string body_template , string body_data , string body_general , string target_ids , array images)

函数参数

参数	含义
string icon	图标类型，如：thread、post、video、goods、reward、debate、blog、album、comment、wall、friend
integer uid	用户 ID
string username	用户名
string title_template	标题模板
string title_data	标题数据数组
string body_template	内容模板
string body_data	模板数据
string body_general	相同事件合并时用到的数据：特定的数组，只有两项：name、link，保留
string target_ids	保留
array images	相关图片的 URL 和链接地址，格式请参考实例

返回值

值	含义
integer	事件的 ID

本接口函数用于向 UCenter Home 添加事件。如果正确则返回事件的 ID。

添加事件示例 (PHP)

$feed = array();
$feed['icon'] = 'thread';
$feed['title_template'] = '<b>{username} 在论坛发起了新话题</b>';
$feed['title_data'] = array('username'=>$discuz_user);
$feed['body_template'] = '<b>{subject}</b><br>{message}';
$feed['body_data'] = array(
	'subject' => "<a href="viewthread.php?tid=$tid">$subject</a>",
	'message' => cutstr(strip_tags(preg_replace("/[.+?]/is", '', $message)), 150)
);
$feed['images'][] = array(
	'url'=>'http://www.discuz.net/logo.gif',
	'link'=> 'http://www.discuz.net/'
);
$feed['images'][] = array(
	'url'=>'http://www.comenz.com/logo.gif',
	'link'=> 'http://www.comenz.com/'
);

include_once(DISCUZ_ROOT.'./uc_client/client.php');
uc_feed_add($feed['icon'], $discuz_uid, $discuz_user, $feed['title_template'], $feed['title_data'],
$feed['body_template'], $feed['body_data'], '', '', $feed['images']);

获取事件

array uc_feed_get(integer limit)

函数参数

参数	含义
integer limit	取事件的条数，默认为 100 条

返回值

值	含义
array	事件列表数据，数组结构请参看附表

本接口函数用于提取事件。如果正确则返回事件列表数组。

获取事件示例 (PHP)

include_once(DISCUZ_ROOT.'./uc_client/client.php');
$arr = uc_feed_get(100);

/**
返回的格式	如下:
Array (
[1] => Array (
	[feedid] => 2
	[appid] => 0
	[icon] => thread
	[uid] => 1
	[username] => admin
	[dateline] => 1203661177
	[hash_template] => c95dbd9aa75862c841b627e1e9598fd5
	[hash_data] => 7f30f7b371cccdcd9901527ac32368ee
	[title_template] => <b>{username} 在论坛发起了新话题</b>
	[title_data] => usernameadmin
	[body_template] => <b>{subject}</b><br />{message}
	[body_data] => subject<a href="viewthread.php?tid=12">主题</a>内容
	[body_general] =>
	[image_1] =>
	[image_1_link] =>
	[image_2] =>
	[image_2_link] =>
	[image_3] =>
	[image_3_link] =>
	[image_4] =>
	[image_4_link] =>
	[target_ids] =>
	)
);
*/

附表：事件列表数组结构

key	含义
integer ['feedid']	事件的 ID
integer ['appid']	所在应用的 ID
string ['icon']	事件的图标 thread、poll、reward 等
integer ['uid']	事件的发起人的用户 ID
string ['username']	发起人的用户名
integer ['dateline']	时间，UNIX 时间戳格式
string ['hash_template']	模板的 Hash 值，用来相同类型事件的合并，32位字符串，如:c95dbd9aa75862c841b627e1e9598fd5
string ['hash_data']	数据的 Hash 值，用来相同类型事件的合并，32位字符串，如:c95dbd9aa75862c841b627e1e9598fd5
string ['title_template']	标题模板
string ['title_data']	标题数据
string ['body_template']	内容模板
string ['body_data']	事件内容 HTML 格式，用 {xxx} 格式字符表示变量，如 {username}
string ['body_general']	保留
string ['image_1']	第一张图片的 URL
string ['image_1_link']	第一张图片链接的 URL
string ['image_2']	第二张图片的 URL
string ['image_2_link	第二张图片链接的 URL
string ['image_3']	第三张图片的 URL
string ['image_3_link']	第三张图片链接的 URL
string ['image_4']	第四张图片的 URL
string ['image_4_link']	第四张图片链接的 URL

接口流程

提交、获取事件

接口函数 uc_feed_add() 提交事件		通知到 UCenter		UCenter Home 使用接口函数 uc_feed_get() 获取提交的事件