WhaleCloud Android SDK 远端文本剪切板接收说明

本文档只说明 SDK 接收远端文本剪切板的使用方法，不包含客户端向远端发送剪切板内容的能力。

1. 使用前提

已完成 WhaleCloud 初始化。

调用 /jyapi/playGame 时已将 copy_mode 配置为 1。

已启动游戏并收到 JyGameStatusListener.onGameBegin()。

当 /jyapi/playGame 的 copy_mode=1 时，当前会话默认开启剪切板复制功能，不需要再调用 /jyapi/shareClipboard，也不需要调用 WhaleCloud.shareClipboard(config)。

调用 /jyapi/playGame 前设置请求参数：

参数	值	说明
`copy_mode`	`1`	默认开启当前会话的剪切板复制功能

该参数必须随 /jyapi/playGame 请求一起提交。游戏启动后直接通过事件回调接收远端文本，无需执行额外的剪切板开启流程。

远端剪切板文本通过启动游戏时传入的 JyGameStatusListener.onEvent(int code, String msg) 回调：

回调字段：

参数	值 / 类型
`code`	`JyCode.EVENT_CLIPER` / `54120`
`msg`	远端剪切板文本 `String`

onEvent() 可能在工作线程触发，更新 UI 前应切换到 Android 主线程。

现象	排查方向
没有剪切板回调	确认 `/jyapi/playGame` 请求已携带 `copy_mode=1`，并确认远端已复制文本
已有接收日志但业务无感知	检查 `JyGameStatusListener.onEvent()` 和 `JyCode.EVENT_CLIPER` 分支
回调后 UI 异常	切换到 Android 主线程后再更新 UI