fusion2.dialog.savePhoto

目录

What's New?

2012年8月22日,本接口支持将上传照片到应用相册的信息同时转播到用户的腾讯微博。
2012年7月17日,本接口开始支持朋友平台上的应用调用;支持获取已上传照片及其缩略图URL。

1 功能说明

“上传照片”前端JS接口。
调用本接口,可上传照片到用户的相册,相册名称为“应用相册”,如果没有该相册则为用户创建该相册。
弹框中支持“点名”功能,被点名的好友将在其个人中心收到相关feeds。
同时还支持在弹框中选择是否同时转播到用户的腾讯微博。
上传成功后,将返回照片地址及缩略图地址(详见接口参数onSuccess的说明),应用可以调用该URL在应用中展示。

注:
1. 本接口目前支持空间平台和朋友平台。相册属于平台基础功能,目前在QQ空间,腾讯朋友都可以找到“相册”模块,其中的相册以及照片数据是同步的。
2. 只支持jpg/png/gif格式的图片,大小不能超过1MB。不符合要求的图片将返回错误消息。

2 接口调用说明

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

接口说明如下:

fusion2.dialog.savePhoto
({
    //照片标题
    title : "扩地证", 
     
    //照片描述。    
    desc : "用应用做了个扩地证", 


    // 必须 。上传到相册的图片URL。只支持jpg/png/gif格式的图片,大小不能超过1MB
    // 图片没有域名限制,但是图片地址的根域名必须要有一个crossdomain.xml 的flash授权文件,详见下文
    img : "http://app24341.imgcache.qzoneapp.com/app24341/hashed/86933d85682a0bbc318616d90fa641bb.png", 


    // 必须。展示在对话框中的小预览图,不会上传到相册
    // 图片没有域名限制,但是要使用crossdomain.xml让Flash可以跨域传输数据
    preview : "http://app24341.imgcache.qzoneapp.com/app24341/hashed/86933d85682a0bbc318616d90fa641bb.png", 


    //可选。透传参数,用于onSuccess和onCancel回调时传入的参数,用于识别请求。
    context : "send-gift-12345", 


    // 可选。用户操作后的回调方法。
    // 可通过opt.photo_url获取照片地址,opt.thumbnail_url获取照片缩略图地址。
    onSuccess : function (opt) 
    { alert("Succeeded: " + opt.context); window.console && console.log(opt);}, 


    // 可选。用户取消操作后的回调方法。
    // 用户取消时将同时关闭对话框,因此将先触发onCancel回调再触发onClose回调。
    onCancel : function (opt) 
    { alert("Cancelled: " + opt.context); }, 


    // 可选。对话框关闭时的回调方法。
    // 主要用于对话框关闭后进行UI方面的调整,onSuccess和onCancel则用于应用逻辑的处理,避免过度耦合
    onClose : function (opt) 
    { alert("Closed") }
  })

3 图片相关注意事项

接口中需要传入图片地址,图片地址的根域名必须要有一个crossdomain.xml 的flash授权文件,以向腾讯的网站授权可以加载到图片。
crossdomain.xml的内容如下:

<?xml version="1.0"?>
<cross-domain-policy>
   <allow-access-from domain="*.qq.com" secure="false" />
   <allow-access-from domain="*.soso.com" secure="false" />
   <allow-access-from domain="*.paipai.com" secure="false" />
   <allow-access-from domain="*.gtimg.cn" secure="false" />
   <allow-access-from domain="*.pengyou.com" secure="false" />
</cross-domain-policy>

4 返回码说明

返回码 含义说明
1 参数错误。
2 图片数据异常。
3 无法保存图片。
4 无法上传图片。
5 HTTP方法必须为POST。
6 图片超出1MB大小限制。
7 请先登录。
8 发送微博错误。

5 效果展示

在应用中设置点击“保存图片”按钮,即可弹出照片保存窗口。如下图所示:
fusion2.dialog.savePhoto.png

用户在弹框中填写图片相关信息,并点名好友后,点击“确定”,即将上传照片到应用相册feeds发表到用户和点名好友的个人中心。
在feeds下面有应用链接,用户点击链接即可进入应用。
以空间平台为例,如下图所示:
fusion2.dialog.savePhoto_1.png

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

FAQ

详见:FusionAPI调用相关问题

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部