From 26522cea3fadf1e6e969765374fc96d5ad94b8da Mon Sep 17 00:00:00 2001 From: klaus Date: Thu, 19 Mar 2026 17:59:37 +0900 Subject: [PATCH] =?UTF-8?q?feat(live-room):=20=EC=B1=84=ED=8C=85=EC=B0=BD?= =?UTF-8?q?=20=EC=96=BC=EB=A6=AC=EA=B8=B0=20=EA=B8=B0=EB=8A=A5=EC=9D=84=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 채팅 입력 제어와 룸 상태 동기화를 통합해 지연 입장자도 동일 상태를 적용한다. --- .../kr/co/vividnext/sodalive/live/LiveApi.kt | 7 + .../vividnext/sodalive/live/LiveRepository.kt | 15 +- .../sodalive/live/room/LiveRoomActivity.kt | 153 ++++++++++++++- .../sodalive/live/room/LiveRoomViewModel.kt | 44 +++++ .../live/room/SetChatFreezeRequest.kt | 10 + .../sodalive/live/room/chat/LiveRoomChat.kt | 17 +- .../live/room/chat/LiveRoomChatRawMessage.kt | 6 +- .../live/room/info/GetRoomInfoResponse.kt | 1 + .../main/res/layout/activity_live_room.xml | 16 ++ app/src/main/res/values-en/strings.xml | 5 + app/src/main/res/values-ja/strings.xml | 5 + app/src/main/res/values/strings.xml | 5 + ...260319_라이브룸채팅창얼리기기능구현계획.md | 181 ++++++++++++++++++ 13 files changed, 460 insertions(+), 5 deletions(-) create mode 100644 app/src/main/java/kr/co/vividnext/sodalive/live/room/SetChatFreezeRequest.kt create mode 100644 docs/20260319_라이브룸채팅창얼리기기능구현계획.md diff --git a/app/src/main/java/kr/co/vividnext/sodalive/live/LiveApi.kt b/app/src/main/java/kr/co/vividnext/sodalive/live/LiveApi.kt index fa76b91b..d89011da 100644 --- a/app/src/main/java/kr/co/vividnext/sodalive/live/LiveApi.kt +++ b/app/src/main/java/kr/co/vividnext/sodalive/live/LiveApi.kt @@ -10,6 +10,7 @@ import kr.co.vividnext.sodalive.live.reservation_status.GetLiveReservationRespon import kr.co.vividnext.sodalive.live.room.CancelLiveRequest import kr.co.vividnext.sodalive.live.room.EnterOrQuitLiveRoomRequest import kr.co.vividnext.sodalive.live.room.LiveRoomStatus +import kr.co.vividnext.sodalive.live.room.SetChatFreezeRequest import kr.co.vividnext.sodalive.live.room.SetManagerOrSpeakerOrAudienceRequest import kr.co.vividnext.sodalive.live.room.StartLiveRequest import kr.co.vividnext.sodalive.live.room.create.CreateLiveRoomResponse @@ -186,6 +187,12 @@ interface LiveApi { @Header("Authorization") authHeader: String ): Single> + @PUT("/live/room/info/set/chat-freeze") + fun setChatFreeze( + @Body request: SetChatFreezeRequest, + @Header("Authorization") authHeader: String + ): Single> + @GET("/live/room/{id}/donation-list") fun donationStatus( @Path("id") id: Long, diff --git a/app/src/main/java/kr/co/vividnext/sodalive/live/LiveRepository.kt b/app/src/main/java/kr/co/vividnext/sodalive/live/LiveRepository.kt index 40bc2645..d5aae0a2 100644 --- a/app/src/main/java/kr/co/vividnext/sodalive/live/LiveRepository.kt +++ b/app/src/main/java/kr/co/vividnext/sodalive/live/LiveRepository.kt @@ -9,6 +9,7 @@ import kr.co.vividnext.sodalive.live.reservation_status.CancelLiveReservationReq import kr.co.vividnext.sodalive.live.room.CancelLiveRequest import kr.co.vividnext.sodalive.live.room.EnterOrQuitLiveRoomRequest import kr.co.vividnext.sodalive.live.room.LiveRoomStatus +import kr.co.vividnext.sodalive.live.room.SetChatFreezeRequest import kr.co.vividnext.sodalive.live.room.SetManagerOrSpeakerOrAudienceRequest import kr.co.vividnext.sodalive.live.room.StartLiveRequest import kr.co.vividnext.sodalive.live.room.create.CreateLiveRoomResponse @@ -112,6 +113,18 @@ class LiveRepository( authHeader = token ) + fun setChatFreeze( + roomId: Long, + isChatFrozen: Boolean, + token: String + ) = api.setChatFreeze( + request = SetChatFreezeRequest( + roomId = roomId, + isChatFrozen = isChatFrozen + ), + authHeader = token + ) + fun getRoomInfo(roomId: Long, token: String) = api.getRoomInfo(roomId, authHeader = token) fun getDonationMessageList( @@ -195,7 +208,7 @@ class LiveRepository( fun setManager(roomId: Long, userId: Long, token: String) = api.setManager( request = SetManagerOrSpeakerOrAudienceRequest(roomId, memberId = userId), - authHeader = token, + authHeader = token ) fun creatorFollow( diff --git a/app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt b/app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt index 1576f6a2..3db8e72d 100644 --- a/app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt +++ b/app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt @@ -100,6 +100,7 @@ import kr.co.vividnext.sodalive.live.room.chat.LiveRoomDonationChat import kr.co.vividnext.sodalive.live.room.chat.LiveRoomJoinChat import kr.co.vividnext.sodalive.live.room.chat.LiveRoomNormalChat import kr.co.vividnext.sodalive.live.room.chat.LiveRoomRouletteDonationChat +import kr.co.vividnext.sodalive.live.room.chat.LiveRoomSystemNoticeChat import kr.co.vividnext.sodalive.live.room.donation.LiveRoomDonationDialog import kr.co.vividnext.sodalive.live.room.donation.LiveRoomDonationMessageDialog import kr.co.vividnext.sodalive.live.room.donation.LiveRoomDonationMessageViewModel @@ -190,6 +191,8 @@ class LiveRoomActivity : BaseActivity(ActivityLiveRoomB // region 채팅 금지 private var isNoChatting = false + private var isChatFrozen = false + private var hasShownInitialChatFreezeNotice = false private var remainingNoChattingTime = NO_CHATTING_TIME private val countDownTimer = object : CountDownTimer(remainingNoChattingTime * 1000, 1000) { override fun onTick(millisUntilFinished: Long) { @@ -241,6 +244,110 @@ class LiveRoomActivity : BaseActivity(ActivityLiveRoomB val noChatRoomList = SharedPreferenceManager.noChatRoomList return noChatRoomList.contains(roomId) } + + private fun setChatFrozenState(isFrozen: Boolean) { + isChatFrozen = isFrozen + updateChatFreezeToggleUi() + updateChatInputState() + } + + private fun updateChatInputState() { + val canInputChat = isHost || !isChatFrozen + binding.etChat.isEnabled = canInputChat + binding.ivSend.isEnabled = canInputChat + binding.ivSend.alpha = if (canInputChat) { + 1f + } else { + 0.4f + } + + if (!canInputChat) { + binding.etChat.clearFocus() + } + } + + private fun updateChatFreezeToggleUi() { + if (isChatFrozen) { + binding.tvChatFreezeSwitch.text = getString(R.string.screen_live_room_chat_freeze_on_label) + binding.tvChatFreezeSwitch.setTextColor( + ContextCompat.getColor( + applicationContext, + R.color.color_3bb9f1 + ) + ) + binding.tvChatFreezeSwitch + .setBackgroundResource(R.drawable.bg_round_corner_5_3_transparent_3bb9f1) + } else { + binding.tvChatFreezeSwitch.text = getString(R.string.screen_live_room_chat_freeze_off_label) + binding.tvChatFreezeSwitch.setTextColor( + ContextCompat.getColor( + applicationContext, + R.color.color_eeeeee + ) + ) + binding.tvChatFreezeSwitch + .setBackgroundResource(R.drawable.bg_round_corner_5_3_transparent_bbbbbb) + } + } + + private fun showChatFreezeWarning() { + Toast.makeText( + applicationContext, + getString(R.string.screen_live_room_chat_freeze_warning), + Toast.LENGTH_SHORT + ).show() + } + + private fun buildChatFreezeStatusMessage(isFrozen: Boolean, actorNickname: String): String { + return getString( + if (isFrozen) { + R.string.screen_live_room_chat_freeze_started + } else { + R.string.screen_live_room_chat_freeze_ended + }, + actorNickname + ) + } + + private fun addChatFreezeStatusMessage(message: String) { + if (message.isBlank()) { + return + } + chatAdapter.items.add( + LiveRoomSystemNoticeChat(message = message) + ) + invalidateChat() + } + + private fun toggleChatFreeze() { + if (!isHost) { + return + } + + val nextChatFrozen = !isChatFrozen + viewModel.setChatFreeze(roomId = roomId, isChatFrozen = nextChatFrozen) { + setChatFrozenState(nextChatFrozen) + + val noticeMessage = buildChatFreezeStatusMessage( + isFrozen = nextChatFrozen, + actorNickname = SharedPreferenceManager.nickname + ) + + addChatFreezeStatusMessage(noticeMessage) + + agora.sendRawMessageToGroup( + rawMessage = Gson().toJson( + LiveRoomChatRawMessage( + type = LiveRoomChatRawMessageType.TOGGLE_CHAT_FREEZE, + message = noticeMessage, + can = 0, + donationMessage = "", + isChatFrozen = nextChatFrozen + ) + ).toByteArray() + ) + } + } // endregion private val onBackPressedCallback = object : OnBackPressedCallback(true) { @@ -509,7 +616,10 @@ class LiveRoomActivity : BaseActivity(ActivityLiveRoomB ) binding.etChat.setOnFocusChangeListener { view, hasFocus -> - if (isNoChatting && hasFocus) { + if (isChatFrozen && !isHost && hasFocus) { + showChatFreezeWarning() + view.clearFocus() + } else if (isNoChatting && hasFocus) { Toast.makeText( applicationContext, getString( @@ -576,6 +686,7 @@ class LiveRoomActivity : BaseActivity(ActivityLiveRoomB binding.tvBgSwitch.setOnClickListener { viewModel.toggleBackgroundImage() } binding.tvSignatureSwitch.setOnClickListener { viewModel.toggleSignatureImage() } + binding.tvChatFreezeSwitch.setOnClickListener { toggleChatFreeze() } binding.tvV2vSignatureSwitch.setOnClickListener { toggleV2vCaption() } binding.llDonation.setOnClickListener { LiveRoomDonationRankingDialog( @@ -1105,6 +1216,20 @@ class LiveRoomActivity : BaseActivity(ActivityLiveRoomB } isHost = response.creatorId == SharedPreferenceManager.userId + binding.tvChatFreezeSwitch.visibility = if (isHost) { + View.VISIBLE + } else { + View.GONE + } + setChatFrozenState(response.isChatFrozen) + + if (!isHost && response.isChatFrozen && !hasShownInitialChatFreezeNotice) { + addChatFreezeStatusMessage( + getString(R.string.screen_live_room_chat_freeze_started) + ) + hasShownInitialChatFreezeNotice = true + } + initLikeHeartButton() initRouletteSettingButton() activatingRouletteButton(isActiveRoulette = response.isActiveRoulette) @@ -1572,7 +1697,9 @@ class LiveRoomActivity : BaseActivity(ActivityLiveRoomB val profileUrl = viewModel.getUserProfileUrl(SharedPreferenceManager.userId.toInt()) val rank = viewModel.getUserRank(SharedPreferenceManager.userId) - if (isNoChatting) { + if (isChatFrozen && !isHost) { + showChatFreezeWarning() + } else if (isNoChatting) { Toast.makeText( applicationContext, getString( @@ -1981,6 +2108,28 @@ class LiveRoomActivity : BaseActivity(ActivityLiveRoomB ) } + LiveRoomChatRawMessageType.TOGGLE_CHAT_FREEZE -> { + if (memberId.toLong() != SharedPreferenceManager.userId) { + handler.post { + val frozen = message.isChatFrozen ?: false + setChatFrozenState(frozen) + + val statusMessage = if (message.message.isNotBlank()) { + message.message + } else { + buildChatFreezeStatusMessage( + isFrozen = frozen, + actorNickname = nickname.ifBlank { + viewModel.getManagerNickname() + } + ) + } + + addChatFreezeStatusMessage(statusMessage) + } + } + } + LiveRoomChatRawMessageType.ROULETTE_DONATION -> { handler.post { chatAdapter.items.add( diff --git a/app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt b/app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt index b84397be..408ef3ee 100644 --- a/app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt +++ b/app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt @@ -543,6 +543,50 @@ class LiveRoomViewModel( _isSignatureOn.value = !isSignatureOn.value!! } + fun setChatFreeze(roomId: Long, isChatFrozen: Boolean, onSuccess: () -> Unit) { + _isLoading.value = true + + compositeDisposable.add( + repository.setChatFreeze( + roomId = roomId, + isChatFrozen = isChatFrozen, + token = "Bearer ${SharedPreferenceManager.token}" + ) + .subscribeOn(Schedulers.io()) + .observeOn(AndroidSchedulers.mainThread()) + .subscribe( + { + _isLoading.value = false + if (it.success) { + if (isRoomInfoInitialized()) { + roomInfoResponse = roomInfoResponse.copy(isChatFrozen = isChatFrozen) + _roomInfoLiveData.postValue(roomInfoResponse) + } + onSuccess() + getRoomInfo(roomId) + } else { + if (it.message != null) { + _toastLiveData.postValue(it.message) + } else { + _toastLiveData.postValue( + SodaLiveApplicationHolder.get() + .getString(R.string.msg_live_room_edit_update_failed) + ) + } + } + }, + { + _isLoading.value = false + it.message?.let { message -> Logger.e(message) } + _toastLiveData.postValue( + SodaLiveApplicationHolder.get() + .getString(R.string.msg_live_room_edit_update_failed) + ) + } + ) + ) + } + fun editLiveRoomInfo( roomId: Long, newTitle: String, diff --git a/app/src/main/java/kr/co/vividnext/sodalive/live/room/SetChatFreezeRequest.kt b/app/src/main/java/kr/co/vividnext/sodalive/live/room/SetChatFreezeRequest.kt new file mode 100644 index 00000000..477bcb4b --- /dev/null +++ b/app/src/main/java/kr/co/vividnext/sodalive/live/room/SetChatFreezeRequest.kt @@ -0,0 +1,10 @@ +package kr.co.vividnext.sodalive.live.room + +import androidx.annotation.Keep +import com.google.gson.annotations.SerializedName + +@Keep +data class SetChatFreezeRequest( + @SerializedName("roomId") val roomId: Long, + @SerializedName("isChatFrozen") val isChatFrozen: Boolean +) diff --git a/app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt b/app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt index 1c65ed8d..992e55b1 100644 --- a/app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt +++ b/app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt @@ -83,13 +83,28 @@ data class LiveRoomJoinChat( } } +@Keep +data class LiveRoomSystemNoticeChat( + val message: String +) : LiveRoomChat() { + override var type = LiveRoomChatType.JOIN + override fun bind(context: Context, binding: ViewBinding, onClickProfile: ((Long) -> Unit)?) { + val itemBinding = binding as ItemLiveRoomJoinChatBinding + itemBinding.tvJoin.setTextColor( + ContextCompat.getColor(context, R.color.color_eeeeee) + ) + itemBinding.tvJoin.text = message + itemBinding.root.setBackgroundResource(R.drawable.bg_round_corner_4_7_cc004462) + } +} + @Keep data class LiveRoomNormalChat( @SerializedName("userId") val userId: Long, @SerializedName("profileUrl") val profileUrl: String, @SerializedName("nickname") val nickname: String, @SerializedName("rank") val rank: Int, - @SerializedName("chat") val chat: String, + @SerializedName("chat") val chat: String ) : LiveRoomChat() { override fun bind(context: Context, binding: ViewBinding, onClickProfile: ((Long) -> Unit)?) { val itemBinding = binding as ItemLiveRoomChatBinding diff --git a/app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt b/app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt index 3e192d12..f8aa4a24 100644 --- a/app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt +++ b/app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt @@ -12,7 +12,8 @@ data class LiveRoomChatRawMessage( @SerializedName("signature") val signature: LiveRoomDonationResponse? = null, @SerializedName("signatureImageUrl") val signatureImageUrl: String? = null, @SerializedName("donationMessage") val donationMessage: String?, - @SerializedName("isActiveRoulette") val isActiveRoulette: Boolean? = null + @SerializedName("isActiveRoulette") val isActiveRoulette: Boolean? = null, + @SerializedName("isChatFrozen") val isChatFrozen: Boolean? = null ) enum class LiveRoomChatRawMessageType { @@ -31,6 +32,9 @@ enum class LiveRoomChatRawMessageType { @SerializedName("TOGGLE_ROULETTE") TOGGLE_ROULETTE, + @SerializedName("TOGGLE_CHAT_FREEZE") + TOGGLE_CHAT_FREEZE, + @SerializedName("ROULETTE_DONATION") ROULETTE_DONATION, diff --git a/app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt b/app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt index 326ba28c..156ccfae 100644 --- a/app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt +++ b/app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt @@ -27,6 +27,7 @@ data class GetRoomInfoResponse( @SerializedName("menuPan") val menuPan: String, @SerializedName("creatorLanguageCode") val creatorLanguageCode: String?, @SerializedName("isActiveRoulette") val isActiveRoulette: Boolean, + @SerializedName("isChatFrozen") val isChatFrozen: Boolean = false, @SerializedName("isPrivateRoom") val isPrivateRoom: Boolean, @SerializedName("password") val password: String? = null ) diff --git a/app/src/main/res/layout/activity_live_room.xml b/app/src/main/res/layout/activity_live_room.xml index 05b3dd70..5bccd907 100644 --- a/app/src/main/res/layout/activity_live_room.xml +++ b/app/src/main/res/layout/activity_live_room.xml @@ -268,6 +268,22 @@ android:visibility="gone" tools:ignore="SmallSp" /> + + [Menu] Leave Change to listener + Freeze OFF + Freeze ON + Chat is frozen. You cannot type right now. + Chat has been frozen. + Chat freeze has been disabled. Sign OFF Caption OFF Caption ON diff --git a/app/src/main/res/values-ja/strings.xml b/app/src/main/res/values-ja/strings.xml index 425e3b70..23d1a7d3 100644 --- a/app/src/main/res/values-ja/strings.xml +++ b/app/src/main/res/values-ja/strings.xml @@ -461,6 +461,11 @@ [メニュー] 退出 リスナー変更 + 凍結 OFF + 凍結 ON + チャットが凍結中のため入力できません。 + チャットを凍結しました。 + チャット凍結を解除しました。 シグ OFF 字幕 OFF 字幕 ON diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml index a69f202e..cdebe6d9 100644 --- a/app/src/main/res/values/strings.xml +++ b/app/src/main/res/values/strings.xml @@ -461,6 +461,11 @@ [메뉴판] 나가기 리스너 변경 + 얼림 OFF + 얼림 ON + 채팅창이 얼려져 있어 입력할 수 없습니다. + 채팅창을 얼렸습니다. + 채팅창 얼리기를 해제했습니다 시그 OFF 자막 OFF 자막 ON diff --git a/docs/20260319_라이브룸채팅창얼리기기능구현계획.md b/docs/20260319_라이브룸채팅창얼리기기능구현계획.md new file mode 100644 index 00000000..1041141f --- /dev/null +++ b/docs/20260319_라이브룸채팅창얼리기기능구현계획.md @@ -0,0 +1,181 @@ +# 20260319_라이브룸채팅창얼리기기능구현계획.md + +## 개요 +- `LiveRoomActivity`에 채팅창 얼리기(Freeze) 토글을 추가한다. +- 채팅창 얼리기 상태에서는 방장을 제외한 모든 사용자가 채팅 입력/전송을 할 수 없어야 한다. +- 본 문서는 계획과 구현/검증 결과를 함께 관리한다. + +## 요구사항 요약 +- 토글 버튼 위치: `activity_live_room.xml`의 `tv_signature_switch` 왼쪽. +- 얼림(ON): 방장 제외 전체 유저 채팅 입력 불가(포커스/입력/전송 모두 차단). +- 녹임(OFF): 기존 채팅금지 해제와 동일하게 채팅 가능 상태로 복귀. +- 상태 메시지: 얼림/녹임 시 모든 유저 채팅 리스트에 시스템 메시지 노출. +- 상태 메시지 UI: 사용자 입장 알림(`LiveRoomJoinChat`)과 동일한 UI 사용. +- 지연 입장: 채팅창이 얼려진 상태로 입장한 사용자도 즉시 상태를 받아 입력 불가여야 함. +- 상태 변경 패턴: 룰렛과 동일하게 방장 ON/OFF 시 서버 API로 상태를 먼저 반영하고, 성공 시 RTM으로 실시간 전파. + +## 상태 저장 전략 판단 (ROOM_INFO vs 별도 상태) +### 결론 +- **ROOM_INFO에 `isChatFrozen` 상태를 저장**하고, RTM 이벤트는 즉시 반영용으로 병행하는 전략을 채택한다. + +### 판단 근거 +- ROOM_INFO 기반 초기 동기화 경로가 이미 존재한다. + - `LiveRoomViewModel.getRoomInfo` -> `roomInfoResponse`/`roomInfoLiveData` 갱신. + - `LiveRoomActivity`는 `onCreate`, `onPresenceEvent(REMOTE_JOIN)` 등에서 `getRoomInfo`를 재호출한다. +- 룸 전역 상태 선례가 존재한다. + - `GetRoomInfoResponse.isActiveRoulette` + `LiveRoomChatRawMessageType.TOGGLE_ROULETTE` 조합으로 운용 중이다. +- 별도 로컬 상태(예: SharedPreferences)는 디바이스 단위라 전역 정합성에 취약하다. + - 현재 `noChatRoomList`는 로컬 단말 재진입 보조 용도이며, 전 유저 상태의 단일 진실원천(SSOT)으로는 부적합하다. +- 외부 근거(Agora Signaling)상 메시지 채널은 pub/sub 모델이므로, 지연 입장자 상태 보장은 저장소(메타데이터/룸 정보) 병행이 유리하다. + +### 외부 레퍼런스(요약) +- Agora Signaling 문서: channel metadata는 room attributes 저장/변경 알림/지속성을 제공하므로 지연 입장 정합성 확보에 적합. + - https://github.com/AgoraIO/Docs-Source/blob/b0d41f805f49a43c041453ce3ca73db2b8292b2f/shared/signaling/store-channel-metadata/index.mdx +- Stream Chat Android: `Channel.frozen` 권위 상태 + 이벤트 병합(`mergeChannelFromEvent`) 패턴으로 freeze 상태를 모델에 유지. + - https://github.com/GetStream/stream-chat-android/blob/40119da704abfd56334db18c0f9fbb29f103f216/stream-chat-android-core/src/main/java/io/getstream/chat/android/models/Channel.kt +- Matrix SDK: `m.room.power_levels` 기반 `maySendMessage` 권한 판별로 room-wide 전송 제한을 구현. + - https://github.com/matrix-org/matrix-js-sdk/blob/028357f15f173770f2dc695e7b2e20d3120bf71a/src/models/room-state.ts +- LiveKit Android: participant metadata/attributes를 서버 권위 상태로 동기화하고 변경 이벤트를 분리 처리. + - https://github.com/livekit/client-sdk-android/blob/c91c476a5d6a674f4ff7f40f5b8326592754dabf/livekit-android-sdk/src/main/java/io/livekit/android/room/participant/Participant.kt + +## 완료 기준 (Acceptance Criteria) +- [x] AC1: 방장이 얼림 ON 시, 방장을 제외한 사용자는 `et_chat`에 포커스/입력/전송이 모두 불가능하다. +- [x] AC2: 방장이 얼림 OFF 시, 방장을 제외한 사용자의 채팅 입력/전송이 즉시 복구된다. +- [x] AC3: 얼림/녹임 이벤트마다 모든 사용자 채팅 리스트에 시스템 상태 메시지가 1회씩 노출된다. +- [x] AC4: 얼림 상태에서 새로 입장한 사용자는 입장 직후 입력 불가 상태를 즉시 적용받는다. +- [x] AC5: 얼리기 토글 버튼은 `tv_signature_switch`의 왼쪽에 배치된다. +- [x] AC6: 방장 얼림 ON/OFF 시 서버 API가 선행 호출되고, 성공한 경우에만 RTM 상태 브로드캐스트가 전송된다. + +## 구현 체크리스트 +### 1) UI/입력 제어 +- [x] `app/src/main/res/layout/activity_live_room.xml` 상단 토글 영역에 `tv_chat_freeze_switch` 추가 (`tv_signature_switch` 왼쪽). +- [x] `LiveRoomActivity`에 전역 상태 변수(`isChatFrozen`) 및 UI 바인딩 로직 추가. +- [x] `etChat` 포커스/입력/전송 경로(`setOnFocusChangeListener`, `inputChat`)를 통합 가드로 정리하여 Freeze 상태에서 완전 차단. + +### 2) 상태 전파/수신 +- [x] 서버 API 경로 반영: 전용 endpoint `PUT /live/room/info/set/chat-freeze` + `SetChatFreezeRequest(roomId, isChatFrozen)`로 ON/OFF를 서버 선반영. +- [x] 저장소/뷰모델 경로 추가: `LiveRepository`/`LiveRoomViewModel`에 chat freeze ON/OFF API 호출 메서드 추가. +- [x] 방장 토글 액션은 API 성공 콜백에서만 RTM 브로드캐스트를 전송하도록 순서 보장(룰렛과 동일). +- [x] API 실패 시 RTM 미전송 + 오류 토스트 처리 시나리오 포함. +- [x] `LiveRoomChatRawMessageType`에 Freeze 이벤트 타입 추가(예: `TOGGLE_CHAT_FREEZE`). +- [x] `LiveRoomChatRawMessage`에 Freeze 상태 전달 필드 추가(예: `isChatFrozen`). +- [x] 방장 토글 시 RTM 그룹 브로드캐스트 전송 + 수신 분기 처리(`rtmEventListener.onMessageEvent`) 구현. + +### 3) 지연 입장 동기화 +- [x] `GetRoomInfoResponse`에 `isChatFrozen` 필드 추가. +- [x] `roomInfoLiveData.observe`에서 `isChatFrozen`을 입력 제어 상태에 반영. +- [x] 입장/재연결/REMOTE_JOIN 시점에서 ROOM_INFO 재조회 흐름으로 상태 재적용이 가능하도록 적용. + +### 4) 시스템 메시지(UI 동일성) +- [x] 입장 알림과 동일한 UI(`item_live_room_join_chat.xml`)를 재사용할 수 있도록 시스템 메시지 모델 경로 확장. +- [x] 얼림/녹임 메시지를 `chatAdapter.items.add(...)` + `invalidateChat()` 경로로 주입. + +### 5) 문자열/국제화 +- [x] `values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml`에 Freeze ON/OFF 라벨/상태 메시지 문구 추가. + +### 6) 검증 +- [x] 정적 진단: 수정 파일 대상 `lsp_diagnostics` 확인. +- [x] 빌드/테스트: `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug` 실행. +- [x] 수동 QA: 연결 단말 설치/실행 경로 확인 및 Activity 진입 시도 결과 기록. + +## 영향 파일(예상) +- `app/src/main/res/layout/activity_live_room.xml` +- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt` +- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt` +- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt` +- `app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt` +- `app/src/main/res/values/strings.xml` +- `app/src/main/res/values-en/strings.xml` +- `app/src/main/res/values-ja/strings.xml` +- `app/src/main/java/kr/co/vividnext/sodalive/live/LiveApi.kt` +- `app/src/main/java/kr/co/vividnext/sodalive/live/LiveRepository.kt` +- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt` + +## 리스크 및 의존성 +- 서버 ROOM_INFO에 `isChatFrozen` 필드가 제공되지 않으면 지연 입장 정합성 보장이 어렵다. +- RTM 메시지만으로 구현하면 pub/sub 특성상 지연 입장 사용자에게 과거 상태 스냅샷이 누락될 수 있다. +- API 성공 이전 RTM을 먼저 전송하면 서버 상태와 클라이언트 UI가 불일치할 수 있으므로, 전송 순서를 API 성공 이후로 강제해야 한다. +- UI 차단을 포커스 차단만으로 처리하면 키보드/입력 우회가 가능하므로 `EditText` 자체 비활성 포함이 필요하다. + +## 검증 기록 +- 2026-03-19 + - 무엇/왜/어떻게: 채팅창 얼리기 기능의 저장 전략 판단을 위해 LiveRoom 내부 구현 패턴, RTM 메시지 경로, ROOM_INFO 동기화 지점을 조사하고 계획 문서로 정리했다. + - 실행 명령/도구: + - `task(subagent_type="explore")` x3 (no-chat 흐름, room state sync, system UI 패턴) + - `task(subagent_type="librarian")` x2 (Agora 상태 전파 문서/실사례) + - `grep("isNoChatting|NO_CHATTING|...")`, `grep("LiveRoomChatRawMessageType|ROOM_INFO|...")` + - `ast_grep_search("LiveRoomChatRawMessage($$$)")` + - `read(LiveRoomActivity.kt, LiveRoomViewModel.kt, Agora.kt, GetRoomInfoResponse.kt, activity_live_room.xml, strings.xml 등)` + - `bash("rg -n ...")` 시도 + - 결과: + - no-chat 기존 구현(로컬 저장 + peer 명령 + 타이머)과 ROOM_INFO 기반 전역 상태 동기화 패턴을 분리 확인. + - `isActiveRoulette` 선례를 통해 ROOM_INFO + RTM 병행 전략이 지연 입장 정합성에 유리함을 확인. + - 시스템 메시지 UI는 `LiveRoomJoinChat`/`item_live_room_join_chat.xml` 재사용이 가장 요구사항에 부합함을 확인. + - 환경에서 `rg` 명령은 미설치(`command not found`)로 확인되어, 동일 탐색은 `grep`/`ast_grep_search`/에이전트 결과로 보완. + +- 2026-03-19 + - 무엇/왜/어떻게: 계획 문서 기준으로 채팅창 얼리기 기능을 구현하고, 룰렛과 동일하게 서버 API 성공 후 RTM 브로드캐스트 순서를 적용했다. + - 실행 명령/도구: + - 코드 반영: `apply_patch` (`LiveRoomActivity.kt`, `LiveRoomViewModel.kt`, `LiveRepository.kt`, `LiveRoomChat.kt`, `LiveRoomChatRawMessage.kt`, `GetRoomInfoResponse.kt`, `EditLiveRoomInfoRequest.kt`, `activity_live_room.xml`, `strings*.xml`) + - 정적 진단: `lsp_diagnostics` (현재 환경 `.kt`, `.xml` 서버 미설정) + - 빌드/테스트: `./gradlew :app:testDebugUnitTest :app:assembleDebug` + - 스타일 검증: `./gradlew :app:ktlintCheck` + - 디바이스 수동 확인: `adb devices`, `./gradlew :app:installDebug`, `adb shell am start -W -n ...LiveRoomActivity --el roomId 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n ...LiveRoomActivity --el roomId 1` + - 결과: + - 초기 빌드에서 `values-en/strings.xml` 신규 문구 1건(`screen_live_room_chat_freeze_warning`) 리소스 컴파일 오류를 확인하고 문구를 수정했다. + - 재실행 결과 `./gradlew :app:testDebugUnitTest :app:assembleDebug` 성공. + - `./gradlew :app:ktlintCheck` 성공. + - `./gradlew :app:installDebug` 성공(연결 단말 1대 설치 확인). + - 셸 직접 실행은 non-exported Activity 제약으로 일반 `am start`가 차단되었고, `run-as` 기반 실행은 가능했으나 디버그 앱 사용자 데이터(`shared_prefs/kr.co.vividnext.sodalive.debug_preferences.xml`)가 비어 있어 실제 라이브룸 시나리오(방장/일반유저 2계정)까지는 환경 제약으로 진행하지 못했다. + +- 2026-03-19 + - 무엇/왜/어떻게: 사용자 요청에 따라 채팅 얼리기 API를 `editLiveRoomInfo`에서 완전히 분리해 전용 URL(`/live/room/info/set/chat-freeze`)로 교체했다. + - 실행 명령/도구: + - 코드 반영: `apply_patch` (`LiveApi.kt`, `LiveRepository.kt`, `LiveRoomViewModel.kt`, `SetChatFreezeRequest.kt`, `EditLiveRoomInfoRequest.kt`) + - 확인: `grep("setChatFreeze|editLiveRoomInfo|/live/room/info/set/chat-freeze")`, `git diff -- LiveApi.kt LiveRepository.kt LiveRoomViewModel.kt SetChatFreezeRequest.kt` + - 결과: + - `setChatFreeze` 호출은 전용 endpoint로 분리되었고 `api.editLiveRoomInfo(...)` 재사용이 제거되었다. + - `EditLiveRoomInfoRequest`의 `isChatFrozen` 필드는 제거되어 채팅 얼리기와 라이브 정보 수정 API 계약이 분리되었다. + +- 2026-03-19 + - 무엇/왜/어떻게: 전용 API 분리 이후 실제 단말 실행 가능 여부를 확인해 수동 QA 착수 가능 상태를 점검했다. + - 실행 명령/도구: + - `adb devices` + - `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1` + - 결과: + - 연결 단말 1대(`2cec640c34017ece`)가 확인되었고, debug 앱 런처 실행 이벤트 주입이 성공했다. + - 채팅 얼리기 엔드투엔드 검증(방장/일반 유저 2계정, 동일 룸 입장, ON/OFF 동기화)은 로그인 세션/테스트 계정/실제 룸 시나리오 준비가 필요해 후속 수동 QA 항목으로 유지한다. + +- 2026-03-19 + - 무엇/왜/어떻게: TODO 잔여 항목(회귀 검증)을 완료하기 위해 테스트/빌드/코드스타일 검증을 단일 Gradle 실행으로 재확인했다. + - 실행 명령/도구: + - `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck` + - 결과: + - `:app:testDebugUnitTest`, `:app:assembleDebug`, `:app:ktlintCheck` 모두 `UP-TO-DATE` 상태로 성공했고 전체 `BUILD SUCCESSFUL`을 확인했다. + - 추가 회귀 및 스타일 위반은 재현되지 않았다. + +- 2026-03-19 + - 무엇/왜/어떻게: 사용자 요청에 따라 채팅창 얼림/해제 시스템 메시지에서 크리에이터 닉네임 노출을 제거하고 고정 문구만 표시되도록 문자열 리소스를 수정했다. + - 실행 명령/도구: + - 코드 반영: `apply_patch` (`app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`) + - 수동 확인: `read(.../values*/strings.xml)`로 `screen_live_room_chat_freeze_started/ended` 값에서 `%1$s` 제거 확인 + - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)`, `lsp_diagnostics(strings.xml)` (환경상 `.kt`/`.xml` LSP 미구성) + - 회귀 검증: `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck` + - 결과: + - 한국어 메시지는 요청대로 `채팅창을 얼렸습니다.`, `채팅창 얼리기를 해제했습니다`로 고정되어 닉네임이 표시되지 않는다. + - `:app:testDebugUnitTest`, `:app:assembleDebug`는 성공했다. + - `:app:ktlintCheck`는 `LiveRoomActivity.kt`의 기존 광범위 스타일 위반으로 실패했으며, 본 요청에서 수정한 문자열 리소스 3개 파일에서는 신규 위반이 관찰되지 않았다. + +- 2026-03-19 + - 무엇/왜/어떻게: 지연 입장 사용자가 얼림 상태를 인지하지 못하는 문제를 해결하기 위해 `isChatFrozen == true` 초기 동기화 시 시스템 메시지를 1회 노출하고, 채팅 입력 영역 터치 시 얼림 토스트를 표시하도록 `LiveRoomActivity`를 수정했다. + - 실행 명령/도구: + - 코드 반영: `apply_patch` (`app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`) + - 정적 확인: `read(LiveRoomActivity.kt)`로 `hasShownInitialChatFreezeNotice`, `rlInputChat.setOnTouchListener`, `roomInfoLiveData.observe` 분기 추가 확인 + - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)` (환경상 `.kt` LSP 미구성) + - 검증: `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck`, `./gradlew :app:testDebugUnitTest :app:assembleDebug` + - 수동 스모크: `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1` + - 결과: + - 지연 입장 초기 동기화에서 non-host + `isChatFrozen=true`일 때 채팅 리스트에 얼림 메시지가 1회 표시되도록 반영했다. + - non-host가 채팅 입력 영역(`rl_input_chat`)을 터치하면 `screen_live_room_chat_freeze_warning` 토스트가 노출되도록 반영했다. + - `:app:testDebugUnitTest`, `:app:assembleDebug`는 성공했다. + - `:app:ktlintCheck`는 `LiveRoomActivity.kt`의 기존 광범위 스타일 위반으로 실패했으며, 이번 수정 라인에서 신규 위반은 확인되지 않았다.