zhini_im/拍摄照片.txt

拍摄照片功能流程梳理
========================================

一、入口：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
- 在后台线程处理图片压缩和缩略图生成
- 在主线程发送消息