fusion2.dialog.selectPhoto

目录

What's New?

2012年11月02日,新增“upload”参数,标识弹框打开的是“相册中选择”tab还是“上传照片”tab。
2012年10月18日,新增“uploadHD”、“insertHD”等参数,支持获取相册的高清大图。

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:打开照片选择对话框。
3. 功能描述:
(1)调用本接口,可打开相片选择器弹框,用户可以在该窗口中选取QQ空间相册中的照片。
(2)用户也可以选择“上传照片”tab,从电脑中选择照片上传。

4. 接口调用限制:
支持的平台:本接口目前支持空间平台和朋友平台。相册属于平台基础功能,目前在QQ空间,腾讯朋友都可以找到“相册”模块,其中的相册以及照片数据是同步的。

2 场景说明

2.1 入口说明

当应用中需要用户上传照片时,在明显的位置放置“添加照片”按钮,方便用户操作。

2.2 弹框效果展示

1. 在应用中点击“添加照片”按钮,弹出照片选择窗口。用户可以在该页面选择1个相册,并选择照片:
fusion.dialog.showphotosel.png

2. 用户也可以点击弹窗中的“从电脑中上传照片”链接,即进入“上传照片”tab。用户可以选择本地照片,然后上传到指定的相册中。
如下图所示:
fusion2.dialog.selectPhoto_1.png

3 接口调用说明

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

3.1 参数说明

参数名称 是否必须 类型 描述
uploadHD string 表示上传图片的方式(0:表示压缩上传;1:表示上传高清图)。
hdWidth string 表示允许上传的高清图的最大宽度,单位为:px。
hdHeight string 表示允许上传的高清图的最大高度,单位为:px。
hdQuality string 表示允许上传的高清图的压缩质量,按96%压缩,请输入固定值:96。
insertHD string 表示返回图片链接的类型(0:表示返回大图(800/670)的url; 1:表示插图框返回高清图的url)。
upload string 标识弹框打开的是“相册中选择”tab还是“上传照片”tab。

0或不传:打开的是第一个tab,即“相册中选择”tab;
1:打开的是第二个tab,即“上传照片”tab。

onSuccess 必须 参数描述:用户操作后的回调方法(opt结构说明详见下文说明)。目前仅支持空间和朋友平台,不支持微博等其它平台。

方法要求: 回调函数的定义符合标准JS函数定义方式,即:function (opt)。 其中opt.data.photos表示用户选取的照片数组,数组中每一个元素可能包括如下属性:desc(图片描述),height(图片高度),name(图片名称),pre(预览图片路径),uploadtime(上传时间),url(图片路径),width(图片宽度)。
触发条件:用户点击弹出框中的“确定”按钮,提示成功,弹出框关闭。

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

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

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

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

3.2 调用示例

fusion2.dialog.selectPhoto

({

  uploadHD : 1,


  hdWidth : 1440,


  hdHeight : 900,


  hdQuality : 96,


  insertHD : 1,


  upload : 0,


  onSuccess : function (opt) {  },


  onCancel : function (opt) {  },


  onClose : function (opt) {  }

});

4 补充说明

1. onSuccess回调里的opt结构体说明

opt结构如下图所示:
fusion.dialog.selectphoto1.png
其中opt.data.photos表示用户选取的照片数组,数组中每一个元素可能包括如下属性:
desc(图片描述),height(图片高度),name(图片名称),pre(预览图片路径),uploadtime(上传时间),url(图片路径),width(图片宽度)。

2. 关于图片的说明

如果成功调用了本接口,则通过onSuccess回调里的opt结构体的属性“url”属性可以获取图片,在浏览器显示照片。
注:本接口是只读接口,不可写。

FAQ

详见:FusionAPI调用相关问题

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部