智慧服务,成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 客户端SDK参考 > Android Native SDK > 接口参考 通讯录

入门使用

通讯录

更新时间:2019-11-20

TsdkEAddrManager(企业通讯录管理类)

接口名称

接口描述

setSystemIcon

设置系统头像。

getUserIcon

获取头像。

setUserDefIcon

设置自定义头像。

searchContacts

搜索联系人。

setSystemIcon

接口描述

设置系统头像。

注意事项

无。

接口所属类

TsdkEAddrManager

方法定义

public int setSystemIcon(int iconId)
 

参数说明

参数名

类型

描述

iconId

int

系统头像序号。

返回值

类型

描述

int

成功返回TSDK_SUCCESS,失败返回相应错误码。

代码示例

//java code
TsdkEAddrManager tsdkEAddrManager = TsdkManager.getInstance().geteAddrManager();
public int setSystemIcon(int resId)
{
    int result = tsdkEAddrManager.setSystemIcon(resId);
    if (result != 0)
    {
        Log.e(TAG, "Set user system icon filed, result -->" + result);
    }
    return result;
}
 

getUserIcon

接口描述

获取联系人头像。

注意事项

无。

接口所属类

TsdkEAddrManager

方法定义

public int getUserIcon(TsdkGetIconParam iconParam)
 

参数说明

参数名

类型

描述

iconParam

TsdkGetIconParam

获取头像请求参数。

返回值

类型

描述

int

成功返回TSDK_SUCCESS,失败返回相应错误码。

代码示例

//java code
TsdkEAddrManager tsdkEAddrManager = TsdkManager.getInstance().geteAddrManager();
//查询联系人头像的序列号
private int queryContactsIconSeq = 1;
//查询用户头像时的map集合
private static Map<Integer, String>querySeqAccountMap = new HashMap<>();

public int getUserIcon(String account)
{
    int seq = queryContactsIconSeq++;
    TsdkGetIconParam iconParam = new TsdkGetIconParam();
    iconParam.setSeqNo(seq);
    iconParam.setAccount(account);
    querySeqAccountMap.put(seq, account);
    int result = tsdkEAddrManager.getUserIcon(iconParam);
    if (result != 0)
    {
        Log.e(TAG, "search user icon failed -->" + result);
    }
    return seq;
}
 

setUserDefIcon

接口描述

设置自定义头像。

注意事项

  • 设置自定义头像需注意:自定义头像信息里需要设置头像的内容以及内容的长度,并且头像需要选择为小头像52*52、中头像120*120和大头像320*320三种其中具体大小应根据服务器要求来定。
  • 图片的格式不支持TIFF格式,推荐使用png格式。
  • 图片的大小服务器没有限制,产品可以根据实际的需要进行限制,建议图片大小最大值为2MB。

接口所属类

TsdkEAddrManager

方法定义

public String setUserDefIcon(TsdkIconInfo iconInfo) 
 

参数说明

参数名

类型

描述

iconInfo

TsdkIconInfo

自定义头像信息。

返回值

类型

描述

String

成功返回头像更新时间,失败返回相应错误码。

代码示例

//java code
TsdkEAddrManager tsdkEAddrManager = TsdkManager.getInstance().geteAddrManager();
public int setDefinedIcon(String smallIconFilePath, String mediumIconFilePath, String largeIconFilePath)
{
    TsdkIconInfo iconInfo = new TsdkIconInfo(smallIconFilePath, mediumIconFilePath, largeIconFilePath);
    String result = tsdkEAddrManager.setUserDefIcon(iconInfo);

    if (null != result)
    {
        return 0;
    }

    return -1;
}
 

searchContacts

接口描述

搜索联系人。

注意事项

无。

接口所属类

TsdkEAddrManager

方法定义

public int searchContacts(TsdkSearchContactsParam searchParam)
 

参数说明

参数名

类型

描述

searchParam

TsdkSearchContactsParam

搜索联系人请求参数。

返回值

类型

描述

int

成功返回TSDK_SUCCESS,失败返回相应错误码。

代码示例

//java code
TsdkEAddrManager tsdkEAddrManager = TsdkManager.getInstance().geteAddrManager();
//查询联系人的序列号
private int queryContactsInfoSeq = 1;

public int searchContacts(String keyWords)
{
    int seq = queryContactsInfoSeq++;
    if (null == keyWords)
    {
        Log.e(TAG, "Search condition is empty");
    }
    TsdkSearchContactsParam searchContactsParam = new TsdkSearchContactsParam();
    searchContactsParam.setDepartmentId("");
    searchContactsParam.setIsExactSearch(0);
    searchContactsParam.setPageIndex(1);
    searchContactsParam.setSearchKeyword(keyWords);
    searchContactsParam.setSeqNo(seq);
    int result = tsdkEAddrManager.searchContacts(searchContactsParam);
    Log.i(TAG, "searchResult -->" + result);
    return seq;
}