描述

用户可以更改自己的头像，使用的头像可以是系统头像也可以是自定义头像。同时用户可以获取头像，在获取头像时服务器会推送获取头像的回调消息给用户，从服务器上得到指定联系人的头像信息。

已完成组件的初始化和登录。

业务流程

设置系统头像

图1 设置系统头像流程 

UI调用tsdk_set_system_icon()设置系统头像。

说明： 

1. 参数icon_id是指系统默认头像图片文件的图片名。图片名一般是数字。这些图片文件保存在用户的本地文件夹中。这些图片不需要从服务器上获取。
2. 禁止修改系统默认头像图片的文件名，以免造成icon_id对应的图片文件与其他用户不一致，导致界面显示用户系统默认头像不一致。
3. 头像大小建议不要超过2M，否则可能影响UI性能。

代码示例：

//c code
TSDK_RESULT ret;
ret = tsdk_set_system_icon(iconId);
if (TSDK_SUCCESS != ret)
{
    LOG_D_CALL_ERROR("set system icon failed. result=%#x", ret);
    return -1;
}
return TSDK_SUCCESS;

设置自定义头像

图2 设置自定义头像流程 

UI调用tsdk_set_user_def_icon()设置自定义头像。

说明： 

1. 设置自定义头像需注意：在参数TSDK_S_ICON_INFO自定义头像信息里需要设置头像的路径，并且头像一般需要选择为：小头像52*52、中头像120*120和大头像320*320三种。其中具体大小应根据服务器要求来定；
2. 图片的格式不支持TIFF格式，推荐使用png格式；
3. 图片的大小服务器没有限制，产品可以根据实际的需要进行限制，建议图片大小最大值为2MB；
4. 若返回成功，则返回设置成功和修改时间，否则返回相应的错误码。

代码示例：

//c code
TSDK_RESULT ret;ret = tsdk_set_user_def_icon(iconInfo,updateTime,length);
if (TSDK_SUCCESS != ret)
{
    LOG_D_CALL_ERROR("set user def icon failed. result=%#x", ret);
    return -1;
}
return TSDK_SUCCESS;

获取联系人头像

图3 搜索联系人头像流程 

1. UI调用tsdk_get_user_icon()搜索联系人头像。
   说明： 

   传入的参数TSDK_S_GET_ICON_PARAM即为获取头像请求参数，需要填写查询的帐户以及序列号。

   代码示例：

   //c code TSDK_RESULT ret; ret = tsdk_get_user_icon(iconParam); if (TSDK_SUCCESS != ret) { LOG_D_CALL_ERROR("get user icon failed. result=%#x", ret); return -1; } return TSDK_SUCCESS;

2. SDK收到服务器下发的获取联系人头像结果，下发TSDK_E_EADDR_EVT_GET_ICON_RESULT的事件，通知给UI所查询的联系人头像内容。
   说明： 

   查询头像的结果信息包括操作结果，查询序号，系统头像id（用户设置的是系统头像）或者自定义头像文件路径（用户设置的是自定义头像）。

   代码示例：

   //c code case TSDK_E_EADDR_EVT_GET_ICON_RESULT: { /*Notify UI*/ }

注意事项

无。