fusion2.dialog.saveBlog

目录

What's New?

2012年08月10日,支持在日志的头部显示日志的来源,并支持将日志同时转播到用户的微博。

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:写日志并保存到QQ空间日志。
3. 功能描述:
(1)要实现“写日志并保存到QQ空间日志”的功能,只需在应用的前端JS代码中调用本接口,并在应用的界面上放置类似“上传日志”的按钮。
(2)调用本接口后,可以将应用中生成好的富文本日志以html的方式在Fusion弹出框中进行预览,用户可选择日志的分类、权限等,还可选择是否同时将日志转播到用户的微博。
(3)用户确认后,点击“发表”,即可将该日志保存到用户的QQ空间日志,根据用户的选择,还可以把日志信息发表到用户的微博。
(4)同时,在发表的日志头部和微博中,显示日志的来源,用户点击链接即可进入应用,为应用带来更多的用户。

4. 接口调用限制:
(1)支持的平台:本接口目前仅支持空间平台。
(2)弹框限制:Fusion弹出框中预览的日志是由应用生成好的,用户不能在该弹出框中进行编辑。

2 场景说明

本接口适用于用户会在应用中结合应用内容产生一些UGC(用户生成内容)的场景:
(1)例如育婴类APP,用户会结合育婴的方法、婴儿食品介绍等写一些育婴日志,用户希望将每天或每周在育婴类APP中写育婴日志保存到自己的QQ空间日志中。
(2)例如游戏类APP,用户会结合游戏场景写一些游戏故事类的日志,并希望将这些故事保存到自己的QQ空间日志中。

2.1 入口说明

在应用的合适位置放置类似“上传日志”的按钮,建议放到明显的地方,便于用户发现和操作。

用户点击“上传日志”按钮后,即可在弹出框中写和应用相关的日志,点击类似“转载”或“上传”按钮,即进入“发表日志”弹框。

2.2 弹框效果展示

弹框中有如下元素:
(1)弹框中有应用生成的日志标题。
(2)弹框中有用户输入的日志内容。
(3)弹框中有应用生成好的富文本日志内容。
(4)弹框中有“日志分类”下拉选择框和“权限”下拉选择框,用户可以选择将日志发表到那个分类下,以及日志的权限。
(5)弹框中有“同时转播到我的腾讯微博”复选框,勾选后,该日志会发表到用户的腾讯微博中。
发表日志弹框如下图所示:
fusion2.dialog.saveBlog.png

2.3 结果展现

用户点击发表后,即将日志发表到QQ空间日志中,如下图所示:
在日志的头部,显示日志来源,用户点击链接即可进入应用。
fusion2.dialog.saveBlog_1.png

如果用户在发表日志时勾选了“同时转播到我的腾讯微博”,即将相关信息发表到用户的微博,如下图所示:
在发表的微博中会带有应用的链接,用户点击链接即可进入应用。
fusion2.dialog.saveBlog_2.png

3 接口调用说明

调用本前端接口前,应用中应该部署Fusion2的跨域文件以及引用脚本,请参阅:Fusion2文档

3.1 参数说明

参数名称 是否必须 类型 描述
title 必须 string 参数描述:日志的标题。

文本显示位置:见上文2.2节弹框图片中的标注1。

content 必须 string 参数描述:日志内容,由应用生成的富文本,HTML格式。

文本显示位置:见上文2.2节弹框图片中的标注3。

context string 参数描述:透传参数,用于onSuccess和onCancel回调,以识别请求。

透传方式:调用本接口时传入该参数,onSuccess或onCancel回调时,在JS中使用opt.context即可获取该透传参数(opt为本接口的回调函数形参)。
例如用户操作成功后,会回调onSuccess时获取该参数的值:

onSuccess : function (opt) 
  {       
      alert("Succeeded: " + opt.context);  
  }
onSuccess 参数描述:用户操作成功后的回调方法。

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。
触发条件:用户点击弹出框中的“发表”按钮,提示成功,弹出框关闭。

onCancel 参数描述:用户取消操作后的回调方法。

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。
触发条件:用户点击取消或弹出框右上角的×按钮,弹出框关闭。用户取消时将同时关闭对话框,因此将先触发onCancel回调再触发onClose回调。

onClose 参数描述:对话框关闭时的回调方法。主要用于对话框关闭后进行UI方面的调整,onSuccess和onCancel则用于应用逻辑的处理,避免过度耦合。

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。
触发条件:用户点击取消或弹出框右上角的×按钮,弹出框关闭。用户取消时将同时关闭对话框,因此将先触发onCancel回调再触发onClose回调。

3.2 调用示例

fusion2.dialog.saveBlog
({
    title : "这里是日志标题", 


    content : "这是一篇育婴日志",


    context : "blog_12345", 


    onSuccess : function (opt) 
    { alert("Succeeded: " + opt.context); window.console && console.log(opt);}, 


    onCancel : function (opt) 
    { alert("Cancelled: " + opt.context); }, 


    onClose : function (opt) 
    { alert("Closed") }
 })

3.3 返回码说明

返回码 含义说明
1 限制发表内容。
-1 发表日志出错。

参数错误。

-2 发表日志出错

请先登录。

-3 发表日志出错。

MKEY错误。

-4到-9 发表日志出错。

系统错误。

-10 发表微博失败。
-11 还没开通空间。
-12 操作过于频繁,请稍后再发表日志。
-13 操作异常, 请稍后再发表日志。
-14 您的号码可能被禁止发言,请联系客服。
-15 您的日志内容可能带有脏话或非法内容,请检查后再发表!
-16 安全旁路命中,需要验证码。

FAQ

详见:FusionAPI调用相关问题

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部