fusion2.dialog.uploadPortrait

调用本接口前,请按照模版提交API接口权限申请(申请方式详见这里),以获取接口调用权限。

目录

1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:为支持某些应用中希望使用用户个性化头像的需求(例如交友类应用希望使用用户的真实头像),特别提供本接口,调用后用户可以上传自定义头像。
3. 功能描述:
(1)调用本接口后将弹出头像上传弹出框,用户上传头像后,平台将存储这些头像(注:只会存储,不会替换原有的用户头像)。
(2)用户在应用中上传成功头像后,应用可回调opt['100']、opt['50']来获取刚才上传的尺寸为100×100px、50×50px的头像的URL。
(3)应用可以通过调用v3/photo/get_portrait_url接口来获取用户当前默认头像的URL,以及历史使用过的头像的URL。

4. 接口调用限制:
本接口目前支持空间平台和朋友平台。

2 场景说明

1. 在应用中放置触发用户上传个性化头像的入口。

2. 用户触发上传个性化头像操作后,应用调用上传头像接口(接口调用详见下文说明),弹出“上传头像”的弹框。

3. 用户上传真实头像的照片,并选择需要使用的区域后,点击“保存”,即可将多种尺寸的头像存储到腾讯服务器。

如下图所示:
fusion2.dialog.uploadPortrait.png

3 接口调用说明

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

接口示例说明如下:

fusion2.dialog.uploadPortrait
({
     //可选。透传参数,用于onSuccess和onCancel回调时传入的参数,用于识别请求。
    context : "reactive_12345", 


    // 可选。用户操作后的回调方法
    // 可以用opt['100'], opt['50']拿到刚才上传的头像的URL
    onSuccess : function (opt) 
     { alert("Succeeded: " + fusion.JSON.stringify(opt)); }, 


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


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

4 返回码说明

返回码 含义说明
1000 初始化错误。
1001 接收图片错误。
1002 参数错误。
1003 上传图片错误。
1004 更新索引错误。
1005 检查文件大小错误。
1006 超出限制频率。
1007 生成openid失败。
1008 生成头像url失败
1010 没有登录。

FAQ

详见:FusionAPI调用相关问题

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部