207 lines
8.1 KiB
Plaintext
207 lines
8.1 KiB
Plaintext
拍摄照片功能流程梳理
|
||
========================================
|
||
|
||
一、入口：ConversationActivity页面
|
||
----------------------------------------
|
||
包名：cn.wildfire.chat.kit.conversation.ConversationActivity
|
||
|
||
1. ConversationActivity包含ConversationFragment
|
||
- ConversationActivity在afterViews()中创建并添加ConversationFragment
|
||
- 文件位置：uikit/src/main/java/cn/wildfire/chat/kit/conversation/ConversationActivity.java
|
||
|
||
2. ConversationFragment包含ConversationInputPanel
|
||
- ConversationFragment在onCreateView()中初始化ConversationInputPanel
|
||
- 文件位置：uikit/src/main/java/cn/wildfire/chat/kit/conversation/ConversationFragment.java
|
||
|
||
|
||
二、点击右下角加号按钮
|
||
----------------------------------------
|
||
包名：cn.wildfire.chat.kit.conversation.ConversationInputPanel
|
||
|
||
1. 加号按钮控件：extImageView (R.id.extImageView)
|
||
- 在bindViews()中绑定控件
|
||
- 设置点击监听器：extImageView.setOnClickListener(v -> onExtImageViewClick())
|
||
|
||
2. onExtImageViewClick()方法处理点击事件
|
||
- 如果当前显示的是扩展面板，则隐藏并显示键盘
|
||
- 否则，显示扩展面板（showConversationExtension()）
|
||
- 文件位置：uikit/src/main/java/cn/wildfire/chat/kit/conversation/ConversationInputPanel.java (338-349行)
|
||
|
||
|
||
三、显示扩展菜单
|
||
----------------------------------------
|
||
包名：cn.wildfire.chat.kit.conversation.ext.core.ConversationExtension
|
||
|
||
1. ConversationExtension管理所有扩展功能
|
||
- 在ConversationInputPanel的init()方法中创建
|
||
- 文件位置：uikit/src/main/java/cn/wildfire/chat/kit/conversation/ext/core/ConversationExtension.java
|
||
|
||
2. 扩展菜单包含多个ConversationExt，其中ImageExt负责图片选择
|
||
- ImageExt类：uikit/src/main/java/cn/wildfire/chat/kit/conversation/ext/ImageExt.java
|
||
- ImageExt的iconResId()返回R.mipmap.ic_func_pic（照片图标）
|
||
|
||
|
||
四、点击照片选项
|
||
----------------------------------------
|
||
包名：cn.wildfire.chat.kit.conversation.ext.ImageExt
|
||
|
||
1. pickImage()方法被调用
|
||
- 使用@ExtContextMenuItem注解标记
|
||
- 方法签名：public void pickImage(View containerView, Conversation conversation)
|
||
|
||
2. 创建ImagePicker Intent
|
||
- ImagePicker.picker().showCamera(true).enableMultiMode(9).buildPickIntent(activity)
|
||
- showCamera(true)表示显示拍照选项
|
||
- enableMultiMode(9)表示最多选择9张图片
|
||
- 文件位置：uikit/src/main/java/cn/wildfire/chat/kit/conversation/ext/ImageExt.java (38-43行)
|
||
|
||
3. 启动ImageGridActivity
|
||
- startActivityForResult(intent, 100)
|
||
- 同时发送TypingMessageContent（TYPING_CAMERA）表示正在使用相机
|
||
|
||
|
||
五、ImageGridActivity图片选择页面
|
||
----------------------------------------
|
||
包名：com.lqr.imagepicker.ui.ImageGridActivity
|
||
|
||
1. onCreate()初始化
|
||
- 从Intent中获取showCamera参数（true）
|
||
- 创建ImageGridAdapter，传入showCamera参数
|
||
- 文件位置：imagepicker/src/main/java/com/lqr/imagepicker/ui/ImageGridActivity.java
|
||
|
||
2. ImageGridAdapter显示拍照按钮
|
||
- 如果showCamera为true，在GridView的第一项显示拍照按钮
|
||
- 文件位置：imagepicker/src/main/java/com/lqr/imagepicker/adapter/ImageGridAdapter.java
|
||
|
||
|
||
六、点击拍照按钮
|
||
----------------------------------------
|
||
包名：com.lqr.imagepicker.ui.ImageGridActivity
|
||
|
||
1. takePhoto()方法被调用
|
||
- 检查相机权限（Manifest.permission.CAMERA）
|
||
- 如果权限已授予，调用Utils.takePhoto()
|
||
- 文件位置：imagepicker/src/main/java/com/lqr/imagepicker/ui/ImageGridActivity.java (165-176行)
|
||
|
||
2. Utils.takePhoto()启动系统相机
|
||
- 生成拍照输出路径：Utils.genTakePhotoOutputPath()
|
||
- 创建Intent：MediaStore.ACTION_IMAGE_CAPTURE
|
||
- 使用FileProvider设置输出路径
|
||
- 启动相机Activity：startActivityForResult(takePictureIntent, REQUEST_CODE_TAKE)
|
||
- 文件位置：imagepicker/src/main/java/com/lqr/imagepicker/Utils.java (77-82行)
|
||
|
||
|
||
七、拍照完成处理
|
||
----------------------------------------
|
||
包名：com.lqr.imagepicker.ui.ImageGridActivity
|
||
|
||
1. onActivityResult()接收拍照结果
|
||
- requestCode == ImagePicker.REQUEST_CODE_TAKE
|
||
- resultCode == Activity.RESULT_OK
|
||
- 调用onTakePhoto()方法
|
||
- 文件位置：imagepicker/src/main/java/com/lqr/imagepicker/ui/ImageGridActivity.java (283-299行)
|
||
|
||
2. onTakePhoto()处理拍照结果
|
||
- 发送广播通知媒体库扫描新图片：Utils.notifyToScanMedia()
|
||
- 创建ImageItem对象，设置path为拍照输出路径
|
||
- 清空已选图片，将新拍的图片添加到选中列表
|
||
- 创建返回Intent，包含选中的图片列表
|
||
- 设置结果并finish()：setResult(Activity.RESULT_OK, intent)
|
||
- 文件位置：imagepicker/src/main/java/com/lqr/imagepicker/ui/ImageGridActivity.java (315-327行)
|
||
|
||
|
||
八、返回ImageExt处理结果
|
||
----------------------------------------
|
||
包名：cn.wildfire.chat.kit.conversation.ext.ImageExt
|
||
|
||
1. onActivityResult()接收结果
|
||
- requestCode == 100
|
||
- resultCode == Activity.RESULT_OK
|
||
- 文件位置：uikit/src/main/java/cn/wildfire/chat/kit/conversation/ext/ImageExt.java (68-112行)
|
||
|
||
2. 处理图片数据
|
||
- 获取选中的图片列表：data.getSerializableExtra(ImagePicker.EXTRA_RESULT_ITEMS)
|
||
- 获取是否压缩标志：data.getBooleanExtra(ImagePicker.EXTRA_COMPRESS, true)
|
||
- 在后台线程处理图片（ChatManager.Instance().getWorkHandler().post()）
|
||
|
||
3. 图片处理逻辑
|
||
- 遍历选中的图片列表
|
||
- 检查是否为GIF文件（isGifFile()）
|
||
- 如果是GIF，调用sendStickerMsg()发送表情
|
||
- 如果不是GIF：
|
||
a. 如果需要压缩，调用ImageUtils.compressImage()压缩图片
|
||
b. 生成缩略图：ImageUtils.genThumbImgFile()
|
||
c. 在主线程调用sendImgMsg()发送图片
|
||
|
||
|
||
九、发送图片消息
|
||
----------------------------------------
|
||
包名：cn.wildfire.chat.kit.viewmodel.MessageViewModel
|
||
|
||
1. sendImgMsg()方法
|
||
- 方法签名：sendImgMsg(Conversation conversation, List<String> toUsers, File imageFileThumb, File imageFileSource)
|
||
- 参数说明：
|
||
* conversation: 会话对象
|
||
* toUsers: 目标用户列表（可为null）
|
||
* imageFileThumb: 缩略图文件
|
||
* imageFileSource: 原图文件
|
||
- 文件位置：uikit/src/main/java/cn/wildfire/chat/kit/viewmodel/MessageViewModel.java
|
||
|
||
2. 发送流程
|
||
- 将File转换为Uri
|
||
- 创建ImageMessageContent消息内容
|
||
- 调用ChatManager发送消息
|
||
|
||
|
||
关键代码文件清单
|
||
========================================
|
||
1. ConversationActivity.java
|
||
uikit/src/main/java/cn/wildfire/chat/kit/conversation/ConversationActivity.java
|
||
|
||
2. ConversationFragment.java
|
||
uikit/src/main/java/cn/wildfire/chat/kit/conversation/ConversationFragment.java
|
||
|
||
3. ConversationInputPanel.java
|
||
uikit/src/main/java/cn/wildfire/chat/kit/conversation/ConversationInputPanel.java
|
||
|
||
4. ConversationExtension.java
|
||
uikit/src/main/java/cn/wildfire/chat/kit/conversation/ext/core/ConversationExtension.java
|
||
|
||
5. ImageExt.java
|
||
uikit/src/main/java/cn/wildfire/chat/kit/conversation/ext/ImageExt.java
|
||
|
||
6. ImageGridActivity.java
|
||
imagepicker/src/main/java/com/lqr/imagepicker/ui/ImageGridActivity.java
|
||
|
||
7. ImagePicker.java
|
||
imagepicker/src/main/java/com/lqr/imagepicker/ImagePicker.java
|
||
|
||
8. Utils.java
|
||
imagepicker/src/main/java/com/lqr/imagepicker/Utils.java
|
||
|
||
9. MessageViewModel.java
|
||
uikit/src/main/java/cn/wildfire/chat/kit/viewmodel/MessageViewModel.java
|
||
|
||
|
||
流程总结
|
||
========================================
|
||
用户操作流程：
|
||
1. 在ConversationActivity页面点击右下角加号按钮
|
||
2. 扩展菜单弹出，点击"照片"选项（ImageExt）
|
||
3. 打开ImageGridActivity图片选择页面
|
||
4. 点击拍照按钮（如果showCamera为true）
|
||
5. 系统相机启动，用户拍照
|
||
6. 拍照完成后，返回ImageGridActivity
|
||
7. ImageGridActivity处理拍照结果，返回ImageExt
|
||
8. ImageExt处理图片（压缩、生成缩略图）
|
||
9. 调用MessageViewModel.sendImgMsg()发送图片消息
|
||
|
||
技术要点：
|
||
- 使用扩展机制（ConversationExt）实现功能模块化
|
||
- 使用ImagePicker库处理图片选择
|
||
- 使用系统相机API（MediaStore.ACTION_IMAGE_CAPTURE）拍照
|
||
- 使用FileProvider处理文件URI
|
||
- 在后台线程处理图片压缩和缩略图生成
|
||
- 在主线程发送消息
|
||
|