此部分接口负责应用间信息的聚合。
添加事件
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 和链接地址，格式请参考实例 |
返回值
本接口函数用于向 UCenter Home 添加事件。如果正确则返回事件的 ID。
$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 |
事件列表数据，数组结构请参看附表
|
本接口函数用于提取事件。如果正确则返回事件列表数组。
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() 获取提交的事件 |