本文介绍如何通过礼物组件实现发送礼物、展示礼物通知。

功能介绍

礼物在 1 对 1 娱乐社交场景中是非常重要的功能，它可以让用户之间更加亲密，提高用户留存率。

礼物组件默认提供了几种礼物类型, 用于展示礼物消息的发送和接收功能。

发送礼物

因礼物会涉及到用户计费计量的逻辑，所以需要开发者根据自己的业务需求，在服务端计费后调用 IM 服务端接口发送礼物消息。

发送礼物的流程如下:

sequenceDiagram
    participant 礼物发送方
    participant 业务服务器
    participant IM服务器
    participant 礼物接收方
    礼物发送方 ->> 业务服务器: 发起送礼物请求
    Note right of 业务服务器: 涉及到计费逻辑，请自行实现 
    业务服务器 ->> IM服务器: 调用IM服务端的发送自定义消息接口通知对方
    IM服务器 -->> 礼物接收方: 礼物消息
    IM服务器 -->> 礼物发送方: 礼物消息
    

1. 客户端向业务服务器发起送礼物请求，涉及到计费逻辑。
2. 计费结算后，业务服务器调用 IM 服务端的发送自定义消息 接口通知礼物发送方和礼物接收方。
3. 送礼方与收礼方收到代表礼物的 IM 的自定义消息，送礼方与收礼方的聊天页面分别展示礼物消息。

自定义发送礼物的界面

目前礼物选择及发送界面为 GiftDialog。

资源	描述
GiftNumSelectDialog	礼物数量选择UI
GiftCache	礼物资源

展示礼物通知

礼物消息通过 IM 自定义消息来实现。您可以通过如下两种方式自定义展示的礼物消息。

基于IM UIKit自定义实现

礼物UI主要是在GiftMessageViewHolder类。

示例代码

   ChatKitClient.addCustomAttach(
        OneOnOneChatCustomMessageType.SEND_GIFT_TYPE, GiftAttachment.class);
    ChatKitClient.addCustomViewHolder(
        OneOnOneChatCustomMessageType.SEND_GIFT_TYPE, GiftMessageViewHolder.class);