fusion2.dialog.shareDemo

本接口只有hosting应用可以申请。non-hosting应用由于flash存储安全性的限制,暂时不能申请本接口。
调用本接口前,请按照模版提交API接入申请(申请方式详见这里),以获取接口调用权限。
在提交申请时,模版中提示了开发者需要提交在feeds中显示的flash URL,flash需符合参数说明中关于参数“flashlink”的规格以及域名要求。

目录

What's New?

2013年01月24日起,接口调用限制使用了统一规则,请参阅:社交渠道使用优化指引

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:发送试玩feeds接口。游戏类应用调用本接口后可以发送试玩feeds,feeds中含有flash,用户可以直接在flash中试玩应用。试玩feeds将为应用带来高质量的新用户。
3. 功能描述:
(1)用户发送试玩feeds后,试玩feeds会在平台所有好友的个人中心展现;
(2)好友可以通过直接点击feeds中的flash(flash有规格限制,详见参数说明中关于“flashlink”的描述),在feeds中试玩应用;
(3)用户试玩flash后若觉得喜欢,可以通过flash中放置的“体验完整版”链接安装应用,并持续活跃;
(4)用户也可以通过点击feeds中的“进入应用”,跳转到应用指定页面。

4. 接口调用限制:
(1)本接口只有hosting应用可以申请。non-hosting应用由于flash存储安全性的限制,暂时不能申请本接口。
(2)支持的平台:本接口目前只支持QQ空间平台。
(2)调用的频率限制:详见社交渠道使用优化指引

2 场景说明

2.1 入口说明

建议应用在合适的场景放置类似“好友试玩”的按钮,鼓励用户点击:
或在用户进入应用时,弹出弹框,弹框中显示类似“好友试玩”的按钮。

用户点击后,应用调用本接口弹出发送试玩弹框。

2.2 弹框效果展示

弹框中有如下元素:
(1)弹框中有关于用户向好友发送试玩的内容描述。
(2)弹框中有应用的试玩flash封面图片,建议flash的封面与应用的画面风格一致,可以体现应用大致玩法。
(3)弹框中有试玩feeds标题和应用的描述,吸引用户点击feeds中的flash。
发送试玩弹框示例如下:
sharedemo_1.png

2.3 结果展现

用户点击“发送试玩”按钮后,用户QQ空间好友可以在个人中心收到该试玩feeds。
试玩feeds如下图所示:
sharedemo_2.png
好友点击play按钮后,flash展开,可点击“开始挑战”进行试玩,也可以点击“体验完整版”进入应用。
flash展开后如下图所示:
sharedemo_3.png

3 接口调用说明

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

3.1 参数说明

:为了使flash符合要求,请严格按照参数“flashlink”的规格以及要求对flash进行开发。

参数名称 是否必须 类型 描述
img 必须 string 参数描述:弹框中显示的flash封面图片URL。建议为应用的图标或者与应用相关的主题图片。

图片显示位置:见上文2.2节弹框图片中的标注2,以及2.3节试玩feeds中的flash封面图片。
图片文件大小:无要求。
图片格式:.jpg, .png, .jpeg。
图片规格:120×120px
是否自动缩放:是。超过120×120px,会按比例进行缩放。
图片URL域名限制:
hosting应用要求将图片存放在APP域名下或腾讯CDN。
non-hosting应用要求将图片上传到该应用开发者QQ号对应的QQ空间相册中。即non-hosting应用图片域名必须为:qq.com、pengyou.com、qzoneapp.com、qqopenapp.com、tqapp.cn。

flashlink 必须 string 参数描述:试玩feeds中flash的URL。

:Flash中的应用安装按钮,点击后必须是通过调用前端JavaScript函数toApp()来响应。不能是直接跳转到应用地址,否则将无法使用。
注意:函数toApp()不是1个Fusion接口,也不是JS自带的函数,是腾讯在试玩feed里引用试玩flash页面时定义的一个JS函数,开发者直接通过flash调用JS的方式来调用toApp();函数即可。

建议flash与应用的画面风格一致,可以体现应用大致玩法。
建议flash的角落放置固定的安装按钮,方便用户能在游戏试玩中随时安装应用。
建议flash的游戏结束页面放置明显的安装按钮和引导文字,引导用户点击安装应用。
flash规格:400×350px
显示位置:2.3节试玩feeds中展开后的flash。
flash URL域名限制:
hosting应用要求将flash存放在APP域名下或腾讯CDN。
non-hosting应用由于flash存储安全性的限制,不能申请本接口。

title string 参数描述:发送试玩弹框中的标题。该标题目前不在试玩feeds中展示,作为保留字段,便于后续feeds展示优化。

长度限制:最多不超过25个汉字(50个字符)。
文本显示位置:见上文2.2节弹框图片中的标注3。

summary string 参数描述:试玩feeds内容描述,建议以生动的文字描述,以吸引用户关注度和试玩的兴趣。

长度限制:最多不超过50个汉字(100个字符),可以为空。
文本显示位置:见上文2.2节弹框图片中的标注4。

msg string 参数描述:弹框中用户输入的试玩内容。

长度限制:最多不超过30个汉字(60个字符),可以为空。
文本显示位置:见上文2.2节弹框图片中的标注1。

source string 参数描述:由开发者自定义该参数内容。

用户发送试玩成功后,试玩feeds中的链接URL中会有app_custom参数,app_custom参数的值与source的值一致。应用可根据好友点击feeds进入应用时CanvasUrl中的app_custom参数的值,判断用户来源。
这里的参数会被URL编码,需要注意编码后的长度不允许超过900个字符。
例如:
用户A发送试玩时,source的值为“openid=001”,用户B发送试玩时,source的值为“openid=002”。用户C分别收到了用户A和用户B的试玩feeds,当用户C点击一个feeds的链接进入应用时,url中会携带app_custom参数,如果app_custom的值为“openid=001”,说明C点击的是A发送的feeds,如果为“openid=002”,说明C点击的是B发送的feeds。

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

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

onSuccess : function (opt) 
  {       
      alert("Succeeded: " + opt.context);  
  }
onShown 参数描述:对话框浮层展现时的回调方法。

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。
触发条件:应用调用本接口时,弹出浮层对话框。

onSuccess 参数描述:用户操作成功后的回调方法。

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

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

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

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

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

3.2 调用示例

fusion2.dialog.shareDemo

({

  title :"热门音乐对战大作《猜歌王》",


  summary :"来了“猜歌王”,一切见分晓!这里有最流行的音乐,最刺激的玩法,敢挑你就来!",


  msg :"我刚刚在《猜歌王》里取得了11632的高分!",


  img :"http://app24341.qzoneapp.com/app24341/feed_clown.png",


  flashlink :"http://app123456.imgcache.qzoneapp.com/app123456/demo.swf",


  source :"ref=demo&act=energy",


  context :"share-demo-12345",


  onShown : function (opt) 
  {  
      alert("Shown");  
  },


  onSuccess : function (opt) 
  {  
      // opt.context:可选。opt.context为调用该接口时的context透传参数,以识别请求
      alert("Succeeded: " + opt.context);  
  },


  onCancel : function (opt) 
  {  
      // opt.context:可选。opt.context为调用该接口时的context透传参数,以识别请求
      alert("Cancelled: " + opt.context);  
  },


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

});


FAQ

详见:FusionAPI调用相关问题

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

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部