test/Docs/chat-emoji-progress-summary.md

Chat Emoji Progress Summary

Scope

• Muc tieu: hoan thien luong chat co emoji (input -> send -> render TMP) cho Unity client.
• Ngu canh: du an dang chuyen doi tu C++ PC sang C# Unity, uu tien giong logic goc.

Bugs Da Tim Thay Va Da Sua

• AUICommon.FilterEmotionSet bi crash NullReferenceException.

  • Nguyen nhan: dung Dictionary enumerator sai (doc Current truoc MoveNext).
  • Da sua: doi sang while (it.MoveNext()), them check null item.

• UnmarshalEditBoxText khong extract item nao.

  • Nguyen nhan: itemMask = 0.
  • Da sua: dung ITEMMASK_ALL = ~0.

• EditBoxItemsSet dung range item-code sai (\u0001..\u0010) gay vo toan bo parse/lookup.

  • Nguyen nhan: constants local khong dong bo voi AUICommon.AUICOMMON_ITEM_CODE_START/END (\uE000..\uE3FF).
  • Da sua:
    • bo constants sai trong EditBoxItemsSet,
    • dung range cua AUICommon cho check/next-char.

• Hien thi raw wire text trong TMP: `` + <0><0:41>.

  • Nguyen nhan: wire format khong phai TMP rich text.
  • Da sua:
    • input chen <sprite name="..."> neu resolve duoc,
    • truoc khi gui convert <sprite> -> wire.

Thay Doi Ve Architecture Emoji/TMP

• Ho tro nhieu bo emoji (9 bo) bang mapping theo set:

  • EmotionSetSpriteAssetEntry (EmotionSetIndex -> TMP_SpriteAsset).
  • EmotionLibrarySpriteMap.SpriteAssetsPerEmotionSet.

• EmotionLibrarySpriteMap da cap nhat:

  • tra dung sprite asset theo emotionSet,
  • fallback ve TmpSpriteAsset de tuong thich cau hinh cu,
  • fallback ten cell_XXXX cho asset cu.

• Converter atlas dat ten sprite theo namespace:

  • tu cell_XXXX -> s{N}_cell_XXXX (N = EmotionSetIndex),
  • tranh trung ten khi gom nhieu pack vao TMP.

Cac File Da Duoc Them/Sua

• Sua:

  • Assets/PerfectWorld/Scripts/Network/CSNetwork/AUICommon.cs
  • Assets/Scripts/ChatInputHandler.cs
  • Assets/Scripts/CECUIManager.cs
  • Assets/PerfectWorld/Scripts/Chat/EmotionData/EmotionLibrarySpriteMap.cs
  • Assets/PerfectWorld/Scripts/Editor/EmotionAtlasConverterCore.cs
  • Assets/PerfectWorld/Scripts/Editor/EmotionAtlasConverterWindow.cs

• Them moi:

  • Assets/PerfectWorld/Scripts/Chat/ChatInputTmpSpriteConverter.cs
  • Assets/PerfectWorld/Scripts/Chat/EmotionData/EmotionSetSpriteAssetEntry.cs
  • Assets/PerfectWorld/Scripts/Editor/EmotionLibrarySpriteMapEditor.cs
  • Assets/Scripts/ChatEmojiQuickTest.cs

Class Test Nhanh

• ChatEmojiQuickTest da duoc tao de test local:
  • nhap text + chen emoji,
  • send va hien thi len TextMeshProUGUI,
  • mo phong luong: TMP tag -> wire -> TMP display.

Viec Can Setup Trong Unity (Bat Buoc)

• EmotionLibrarySpriteMap:

  • gan Library,
  • sync va gan du SpriteAssetsPerEmotionSet cho 9 bo.

• TMP asset:

  • dam bao sprite naming khop (s{N}_cell_XXXX),
  • setup fallback sprite assets de resolve du tat ca bo khi dung <sprite name>.

• Input/Output TMP:

  • co sprite asset va fallback phu hop.

Ket Qua Ky Vong

• Khong con crash tai FilterEmotionSet.
• Khong con hien raw wire text khi da qua conversion dung luong.
• Co the nhap emoji, gui len, va hien thi icon tren TextMeshProUGUI (neu setup asset dung).

Cap nhat bug nghiem trong: chon set khac van ra emoji set 1 (2026-04-09)

• Hien tuong:

  • Co 9 bo emoji.
  • Chon emoji o set 1 thi dung.
  • Chon set 2..8 van render hinh cua set 1.

• Nguyen nhan goc:

  • Tag TMP dang tao dang <sprite name="cell_XXXX"> (hoac <sprite index=...>), khong chi dinh ro TMP_SpriteAsset.
  • Khi nhieu sprite asset deu co cung ten cell_XXXX, TMP uu tien asset mac dinh/fallback dau tien => thuong la set 1.

• Cach sua da ap dung:

  • Them SpriteAssetName vao EmotionSpriteInfo.
  • EmotionLibrarySpriteMap.TryGetSprite(...) tra them ten asset theo tung emotionSet (set.TmpSpriteAsset.name).
  • EmotionTMPTagBuilder.BuildSpriteTag(...) tao tag co kem asset:
    • <sprite="Emotions N" name="cell_XXXX">
    • hoac <sprite="Emotions N" anim="start,end,fps">
    • hoac <sprite="Emotions N" index=N>.
  • AUICommon.ConvertEmotionsToTMP(...) dung chung EmotionTMPTagBuilder.BuildSpriteTag(info) de tat ca luong render dong nhat.

• File da sua cho fix nay:

  • Assets/PerfectWorld/Scripts/Network/CSNetwork/AUICommon.cs
  • Assets/PerfectWorld/Scripts/Chat/EmotionTMPTagBuilder.cs
  • Assets/PerfectWorld/Scripts/Chat/EmotionData/EmotionLibrarySpriteMap.cs

• Dieu kien setup de hoat dong dung:

  • Trong EmotionLibrarySO, moi EmotionSetSnapshot phai gan dung TmpSpriteAsset tuong ung tung set.
  • Ten asset can on dinh, vi du Emotions 0, Emotions 1, ...; tag su dung chinh ten nay.

• Ket qua sau fix:

  • Emoji duoc resolve dung theo emotionSet.
  • Khong con tinh trang chon set khac nhung hien thi hinh cua set 1.