一个基于健身的社交App，内含跑步轨迹绘制，数据可视化展示，即时通讯，看新闻等模块(毕设&课设&实训&大作业&竞赛&项目)

# 云信 UI 组件使用说明 云信 UI 组件提供了构建IM功能所需的基本功能模块：聊天窗口、最近联系人列表、通讯录列表、联系人选择器、群名片。其他功能有：照片选择、查看大图、视频采集与播放。 UI组件工程提供了较为简洁的接口，开发者可基于组件快速的实现聊天界面和最近联系人功能，并实现基础的一些定制化开发。云信的 UI 组件完全开源，如果开发者希望修改界面，只需要通过替换界面资源，修改layout 等方式即可实现。如果开发者希望更深层次的自定义，也可自行修改代码。 ## <span id="初始化 UI 组件"> 初始化 UI 组件 </span> 导入UIKit - [Eclipse导入UIKit](http://note.youdao.com/share/?id=a8e904df99e1a114c5b565568a19906d&type=note "target=_blank") - [Android Studio导入UIKit](http://note.youdao.com/share/?id=66d12a2aa10b37928b869feaef54ec3e&type=note "target=_blank") 并在 Application 中初始化： ``` public class NimApplication extends Application { public void onCreate() { // ... your codes // 初始化云信SDK NIMClient.init(this, loginInfo(), options()); // ... your codes if (inMainProcess()) { // 在主进程中初始化UI组件，判断所属进程方法请参见demo源码。 initUiKit(); // ... your codes } } private void initUiKit() { // 设置用户资料提供者（必须）,通讯录提供者（必须） NimUIKit.init(this, new UserInfoProvider(){ ... }, new ContactProvider() { ... }); // 注册定位信息提供者类（可选）,如果需要发送地理位置消息，必须提供。 // demo中使用高德地图实现了该提供者，开发者可以根据自身需求，选用高德，百度，google等任意第三方地图和定位SDK。 NimUIKit.setLocationProvider(new NimDemoLocationProvider()); // 会话窗口的定制初始化: 示例代码可详见demo源码中的SessionHelper类。 // 1.注册自定义消息附件解析器（可选） // 2.注册各种扩展消息类型的显示ViewHolder（可选） // 3.设置会话中点击事件响应处理（一般需要） SessionHelper.init(); // 通讯录列表定制初始化：示例代码可详见demo源码中的ContactHelper类。 // 1.设置通讯录列表中点击事响应处理（一般需要） ContactHelper.init(); } ``` UIKit 中用到的 Activity 已经在 uikit 工程的 AndroidManifest.xml 文件中注册好，上层 APP 的AndroidManifest 文件无需再去添加注册。除观看视频的 WatchVideoActivity 需要用到黑色主题，因此单独写了 style 外，其他 Activity 均使用项目默认主题。 同只使用 nimlib SDK 一样，需要参考接入云信 SDK 指南文档，在 AndroidManifest 文件中声明云信 SDK 所用到的 service 和 BroadcastReceiver 组件。 `NimUIKit` 是 UIKit 的接口，提供了 UI 组件的所有能力，上述初始化代码中的注册、设置等函数中均在 `NimUIKit` 中，下文将逐一介绍。 ### <span id="设置用户资料提供者"> 设置用户资料提供者</span> 网易云信不托管用户资料数据，用户资料由第三方 APP 服务器自行管理，当 UI 组件显示需要用到用户资料（`UserInfo`）时，会通过 `UserInfoProvider` 来获取，开发者在初始化 UIKit 时必须设置用户资料提供者，需要实现： - 根据用户帐号返回用户资料，一般 APP 的设计会先从本地缓存中获取，当本地缓存中没有时，则需要异步请求远程服务器，当数据返回时需要通知 UIKit 刷新界面（重新载入用户资料数据），接口为NimUIKit.notifyUserInfoChanged(accounts); - 返回用户默认头像资源 ID，当本地缓存不存在时，先显示默认头像 - 为通知栏提供用户头像（一般从本地缓存中取，若未下载或本地不存在，返回 null，通知栏将显示默认头像） - 根据群 ID 返回群头像位图 > 注意：第三方 APP 的用户资料类需要实现 `UserInfo` 接口，接口中需要提供用户帐号，用户名(用户昵称)，用户头像位图，默认头像资源ID。 在 demo 中，头像采用的圆形剪切绘制。开发者可调用 `HeadImageView#setMask` 修改头像形状，demo 中提供了 `nim_portrait_mask_round` 和 `nim_portrait_mask_square` 两种。 示例如下： ``` private UserInfoProvider infoProvider = new UserInfoProvider() { @Override public UserInfo getUserInfo(String account) { // 先从本地缓存中获取 UserInfo user = NimUserInfoCache.getInstance().getUserInfo(account); if (user == null) { // 若缓存中没有，则发起异步请求数据，回调返回时调用NimUIKit.notifyUserInfoChanged(accounts);来通知UI更新 NimUserInfoCache.getInstance().getUserInfoFromRemote(account, null); } return user; } @Override public int getDefaultIconResId() { return R.drawable.avatar_def; } @Override public Bitmap getAvatarForMessageNotifier(String account) { UserInfo user = getUserInfo(account); if (user != null && !TextUtils.isEmpty(user.getAvatar())) { return ImageLoaderKit.getBitmapFromCache(user.getAvatar(), R.dimen.avatar_size_default, R.dimen.avatar_size_default); } return null; } @Override public Bitmap getTeamIcon(String tid) { Drawable drawable = getResources().getDrawable(R.drawable.avatar_group); if (drawable instanceof BitmapDrawable) { return ((BitmapDrawable) drawable).getBitmap(); } return null; } }; ``` ### <span id="设置通讯录提供者"> 设置通讯录提供者</span> 如果需要使用 UIKit 的通讯录功能（通讯录列表、联系人选择器），需要提供通讯录相关的数据源，需要实现 `ContactProvider` 并在 UIKit 初始化时设置： - 返回本地所有好友用户信息 - 返回我的好友数量，提供给通讯录显示所有联系人数量使用 - 返回一个用户显示名（例如：如果有昵称显示昵称，如果没有显示帐号） 示例如下： ``` private ContactProvider contactProvider = new ContactProvider() { @Override public List<UserInfoProvider.UserInfo> getUserInfoOfMyFriends() { List<NimUserInfo> nimUsers = NimUserInfoCache.getInstance().getUsersOfMyFriend(); List<UserInfoProvider.UserInfo> users = new ArrayList<>(nimUsers.size()); if (!nimUsers.isEmpty()) { users.addAll(nimUsers); } return users; } @Override public int getMyFriendsCount() { return FriendDataCache.getInstance().getMyFriendCounts(); // 好友关系缓存 } @Override public String getUserDisplayName(String account) { return NimUserInfoCache.getInstance().getUserDisplayName(account); // 用户资料缓存 } }; ``` ## <span id="最近联系人列表"> 最近联系人列表</span> ### <span id="集成最近联系人列表"> 集成最近联系人列表</span> 下面演示集成最近联系人列表 `RecentContactsFragment` ``` public class SessionListFragment extends MainTabFragment { private RecentContactsFragment contactsFragment; public void onActivityCreated(Bundle savedInstanceState) { super.onActivityCreated(savedInstanceState); addRecentContactsFragment(); } // 将最近联系人列表fragment动态集成进来。开发者也可以使用在xml中配置的方式静态集成。 private void addRecentContactsFragment() { contactsFragment = new RecentContactsFragment(); // 设置要集成联系人列表fragment的布局文件 contactsFragment.setContainerId(R.id.messages_fragment); TActio