first commit
This commit is contained in:
716
guides/JavaScript调用原生接口文档/TSGame_JSBridge_系统功能与交互.md
Normal file
716
guides/JavaScript调用原生接口文档/TSGame_JSBridge_系统功能与交互.md
Normal file
@@ -0,0 +1,716 @@
|
||||
# TSGame JSBridge 接口文档 - 系统功能与交互
|
||||
|
||||
**版本**: v1.9
|
||||
**更新时间**: 2025年7月13日
|
||||
**文档类型**: 接口规范文档 - 第二部分
|
||||
|
||||
## 文档说明
|
||||
|
||||
本文档是TSGame JSBridge接口规范文档的第二部分，专注于系统功能与交互相关接口，包括剪贴板操作、游戏状态管理、设备状态检测等功能。
|
||||
|
||||
**适用平台**: Android / HarmonyOS
|
||||
**接口范围**: 剪贴板操作、游戏管理、设备状态检测
|
||||
|
||||
### 本文档包含的接口
|
||||
|
||||
| 接口名称 | 调用方向 | 主要功能 | 使用场景 |
|
||||
|----------|----------|----------|----------|
|
||||
| `gameCopytext` | WebView→App | 复制文本到剪贴板 | 文本复制分享功能 |
|
||||
| `gamepastetext` | WebView→App | 获取剪贴板内容 | 文本粘贴读取功能 |
|
||||
| `getGameinstall` | WebView→App | 检查游戏安装状态 | 本地游戏文件检测 |
|
||||
| `getphonestate` | WebView→App | 获取电话通话状态 | 通话状态检测 |
|
||||
| `SwitchOverGameData` | WebView→App | 启动指定游戏 | 游戏切换和启动 |
|
||||
| `backgameData` | WebView→App | 返回数据到上级页面 | 页面数据回传 |
|
||||
|
||||
---
|
||||
|
||||
## 1. 文本复制接口 (gameCopytext)
|
||||
|
||||
### 接口概述
|
||||
当WebView需要将文本内容复制到系统剪贴板时，通过此接口实现跨应用的文本复制功能，用户可以在其他应用中粘贴使用。
|
||||
|
||||
### 工作流程
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant User as 用户
|
||||
participant WebView as WebView
|
||||
participant App as App
|
||||
participant Clipboard as 系统剪贴板
|
||||
participant System as 系统
|
||||
|
||||
User->>WebView: 触发复制操作
|
||||
WebView->>App: 调用gameCopytext接口
|
||||
App->>App: 接收要复制的文本
|
||||
App->>Clipboard: 写入文本到剪贴板
|
||||
Clipboard->>System: 更新系统剪贴板
|
||||
App->>WebView: 返回复制结果
|
||||
WebView->>User: 显示复制成功提示
|
||||
```
|
||||
|
||||
### 参数规范
|
||||
|
||||
#### 调用格式
|
||||
```javascript
|
||||
WebViewJavascriptBridge.callHandler('gameCopytext', textContent, function(response) {
|
||||
console.log('文本复制结果:', response);
|
||||
});
|
||||
```
|
||||
|
||||
#### 参数说明
|
||||
| 参数 | 类型 | 必需 | 说明 | 示例值 |
|
||||
|------|------|------|------|--------|
|
||||
| textContent | string | ✓ | 要复制的文本内容 | "邀请码: ABC123" |
|
||||
|
||||
### 接口调用示例
|
||||
|
||||
#### 复制邀请码
|
||||
```javascript
|
||||
function copyInviteCode(code) {
|
||||
const copyText = `邀请码: ${code}`;
|
||||
|
||||
WebViewJavascriptBridge.callHandler('gameCopytext', copyText, function(response) {
|
||||
if (response === 'success') {
|
||||
showMessage('邀请码已复制到剪贴板');
|
||||
} else {
|
||||
showMessage('复制失败，请重试');
|
||||
}
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
#### 复制游戏链接
|
||||
```javascript
|
||||
function copyGameLink(gameId) {
|
||||
const gameLink = `https://game.example.com/play/${gameId}`;
|
||||
|
||||
WebViewJavascriptBridge.callHandler('gameCopytext', gameLink, function(response) {
|
||||
if (response === 'success') {
|
||||
showMessage('游戏链接已复制');
|
||||
} else {
|
||||
showMessage('复制失败');
|
||||
}
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
### HarmonyOS实现要点
|
||||
- **接口名称**: `gameCopytext`
|
||||
- **调用方向**: WebView → App
|
||||
- **参数格式**: 字符串类型的文本内容
|
||||
- **权限要求**: 无特殊权限要求
|
||||
- **错误处理**: 返回success/failure状态
|
||||
|
||||
---
|
||||
|
||||
## 2. 获取剪贴板内容接口 (gamepastetext)
|
||||
|
||||
### 接口概述
|
||||
当WebView需要读取系统剪贴板中的文本内容时，通过此接口获取用户复制的文本数据，常用于邀请码输入等场景。
|
||||
|
||||
### 工作流程
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant User as 用户
|
||||
participant WebView as WebView
|
||||
participant App as App
|
||||
participant Clipboard as 系统剪贴板
|
||||
|
||||
User->>WebView: 触发粘贴操作
|
||||
WebView->>App: 调用gamepastetext接口
|
||||
App->>Clipboard: 读取剪贴板内容
|
||||
Clipboard->>App: 返回文本内容
|
||||
App->>WebView: 回传文本内容
|
||||
WebView->>WebView: 处理粘贴的文本
|
||||
WebView->>User: 显示粘贴内容
|
||||
```
|
||||
|
||||
### 参数规范
|
||||
|
||||
#### 调用格式
|
||||
```javascript
|
||||
WebViewJavascriptBridge.callHandler('gamepastetext', '', function(clipboardText) {
|
||||
console.log('剪贴板内容:', clipboardText);
|
||||
});
|
||||
```
|
||||
|
||||
#### 参数说明
|
||||
| 参数 | 类型 | 必需 | 说明 | 取值 |
|
||||
|------|------|------|------|------|
|
||||
| data | string | ✓ | 固定传入空字符串 | "" |
|
||||
|
||||
### 接口调用示例
|
||||
|
||||
#### 智能邀请码输入
|
||||
```javascript
|
||||
function smartPasteInviteCode() {
|
||||
WebViewJavascriptBridge.callHandler('gamepastetext', '', function(clipboardText) {
|
||||
if (clipboardText) {
|
||||
// 检查是否包含邀请码格式
|
||||
const inviteCodeMatch = clipboardText.match(/[A-Z0-9]{6,10}/);
|
||||
|
||||
if (inviteCodeMatch) {
|
||||
const inviteCode = inviteCodeMatch[0];
|
||||
document.getElementById('inviteCodeInput').value = inviteCode;
|
||||
showMessage('已自动填入邀请码: ' + inviteCode);
|
||||
} else {
|
||||
showMessage('剪贴板中没有找到有效的邀请码');
|
||||
}
|
||||
} else {
|
||||
showMessage('剪贴板为空');
|
||||
}
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
#### 通用文本粘贴
|
||||
```javascript
|
||||
function pasteTextToInput(inputId) {
|
||||
WebViewJavascriptBridge.callHandler('gamepastetext', '', function(clipboardText) {
|
||||
if (clipboardText) {
|
||||
const inputElement = document.getElementById(inputId);
|
||||
if (inputElement) {
|
||||
inputElement.value = clipboardText;
|
||||
inputElement.focus();
|
||||
showMessage('已粘贴文本');
|
||||
}
|
||||
} else {
|
||||
showMessage('剪贴板中没有文本内容');
|
||||
}
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
### HarmonyOS实现要点
|
||||
- **接口名称**: `gamepastetext`
|
||||
- **调用方向**: WebView → App
|
||||
- **参数格式**: 空字符串
|
||||
- **权限要求**: 可能需要剪贴板读取权限
|
||||
- **返回数据**: 直接返回剪贴板中的文本内容
|
||||
|
||||
---
|
||||
|
||||
## 3. 游戏安装状态检查接口 (getGameinstall)
|
||||
|
||||
### 接口概述
|
||||
检查指定游戏是否已在设备上安装，用于判断是否需要下载游戏资源或显示不同的操作按钮。
|
||||
|
||||
### 工作流程
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant WebView as WebView
|
||||
participant App as App
|
||||
participant FileSystem as 文件系统
|
||||
participant GameFiles as 游戏文件
|
||||
|
||||
WebView->>App: 调用getGameinstall接口
|
||||
App->>App: 解析游戏ID参数
|
||||
App->>FileSystem: 检查游戏安装路径
|
||||
FileSystem->>GameFiles: 验证游戏文件完整性
|
||||
GameFiles->>FileSystem: 返回文件状态
|
||||
FileSystem->>App: 返回安装状态
|
||||
App->>WebView: 回传安装结果
|
||||
WebView->>WebView: 更新UI显示
|
||||
```
|
||||
|
||||
### 参数规范
|
||||
|
||||
#### 调用格式
|
||||
```javascript
|
||||
WebViewJavascriptBridge.callHandler('getGameinstall', gameId, function(isInstalled) {
|
||||
console.log('游戏安装状态:', isInstalled);
|
||||
});
|
||||
```
|
||||
|
||||
#### 参数说明
|
||||
| 参数 | 类型 | 必需 | 说明 | 示例值 |
|
||||
|------|------|------|------|--------|
|
||||
| gameId | string | ✓ | 游戏标识符 | "game_001", "poker", "landlord" |
|
||||
|
||||
#### 返回值说明
|
||||
| 返回值 | 含义 |
|
||||
|--------|------|
|
||||
| "true" | 游戏已安装 |
|
||||
| "false" | 游戏未安装 |
|
||||
|
||||
### 接口调用示例
|
||||
|
||||
#### 游戏状态检查器
|
||||
```javascript
|
||||
const GameStatusChecker = {
|
||||
// 检查单个游戏状态
|
||||
checkGameStatus(gameId, callback) {
|
||||
WebViewJavascriptBridge.callHandler('getGameinstall', gameId, function(isInstalled) {
|
||||
const status = isInstalled === 'true';
|
||||
console.log(`游戏 ${gameId} 安装状态:`, status);
|
||||
|
||||
if (callback) {
|
||||
callback(gameId, status);
|
||||
}
|
||||
});
|
||||
},
|
||||
|
||||
// 批量检查游戏状态
|
||||
checkMultipleGames(gameIds, callback) {
|
||||
const results = {};
|
||||
let completed = 0;
|
||||
|
||||
gameIds.forEach(gameId => {
|
||||
this.checkGameStatus(gameId, (id, isInstalled) => {
|
||||
results[id] = isInstalled;
|
||||
completed++;
|
||||
|
||||
if (completed === gameIds.length) {
|
||||
callback(results);
|
||||
}
|
||||
});
|
||||
});
|
||||
},
|
||||
|
||||
// 更新游戏列表UI
|
||||
updateGameListUI(gameStatuses) {
|
||||
Object.keys(gameStatuses).forEach(gameId => {
|
||||
const gameElement = document.getElementById(`game_${gameId}`);
|
||||
const isInstalled = gameStatuses[gameId];
|
||||
|
||||
if (gameElement) {
|
||||
const button = gameElement.querySelector('.game-action-btn');
|
||||
|
||||
if (isInstalled) {
|
||||
button.textContent = '开始游戏';
|
||||
button.className = 'game-action-btn btn-play';
|
||||
button.onclick = () => this.startGame(gameId);
|
||||
} else {
|
||||
button.textContent = '下载游戏';
|
||||
button.className = 'game-action-btn btn-download';
|
||||
button.onclick = () => this.downloadGame(gameId);
|
||||
}
|
||||
}
|
||||
});
|
||||
},
|
||||
|
||||
// 启动游戏
|
||||
startGame(gameId) {
|
||||
// 调用游戏启动接口
|
||||
WebViewJavascriptBridge.callHandler('SwitchOverGameData', gameId, function(response) {
|
||||
console.log(`游戏 ${gameId} 启动请求已发送`);
|
||||
});
|
||||
},
|
||||
|
||||
// 下载游戏
|
||||
downloadGame(gameId) {
|
||||
showMessage(`开始下载游戏: ${gameId}`);
|
||||
// 实现游戏下载逻辑
|
||||
}
|
||||
};
|
||||
|
||||
// 页面加载时检查所有游戏状态
|
||||
document.addEventListener('DOMContentLoaded', function() {
|
||||
const gameIds = ['poker', 'landlord', 'mahjong', 'chess'];
|
||||
|
||||
GameStatusChecker.checkMultipleGames(gameIds, function(results) {
|
||||
GameStatusChecker.updateGameListUI(results);
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
### HarmonyOS实现要点
|
||||
- **接口名称**: `getGameinstall`
|
||||
- **调用方向**: WebView → App
|
||||
- **参数格式**: 字符串类型的游戏ID
|
||||
- **文件检查**: 验证游戏文件完整性和版本
|
||||
- **返回格式**: 字符串"true"或"false"
|
||||
|
||||
---
|
||||
|
||||
## 4. 电话状态检测接口 (getphonestate)
|
||||
|
||||
### 接口概述
|
||||
获取设备当前的电话通话状态，用于在通话期间暂停游戏或调整音频设置，确保良好的用户体验。
|
||||
|
||||
### 工作流程
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant WebView as WebView
|
||||
participant App as App
|
||||
participant TelephonyService as 电话服务
|
||||
participant PhoneState as 通话状态
|
||||
|
||||
WebView->>App: 调用getphonestate接口
|
||||
App->>TelephonyService: 查询电话状态
|
||||
TelephonyService->>PhoneState: 获取当前通话状态
|
||||
PhoneState->>TelephonyService: 返回状态信息
|
||||
TelephonyService->>App: 回传电话状态
|
||||
App->>WebView: 返回状态结果
|
||||
WebView->>WebView: 根据状态调整应用行为
|
||||
```
|
||||
|
||||
### 参数规范
|
||||
|
||||
#### 调用格式
|
||||
```javascript
|
||||
WebViewJavascriptBridge.callHandler('getphonestate', '', function(phoneState) {
|
||||
console.log('电话状态:', phoneState);
|
||||
});
|
||||
```
|
||||
|
||||
#### 参数说明
|
||||
| 参数 | 类型 | 必需 | 说明 | 取值 |
|
||||
|------|------|------|------|------|
|
||||
| data | string | ✓ | 固定传入空字符串 | "" |
|
||||
|
||||
#### 返回值说明
|
||||
| 返回值 | 含义 |
|
||||
|--------|------|
|
||||
| "0" | 空闲状态（无通话） |
|
||||
| "1" | 响铃状态（来电） |
|
||||
| "2" | 通话中状态 |
|
||||
|
||||
### 接口调用示例
|
||||
|
||||
#### 通话状态监控器
|
||||
```javascript
|
||||
const PhoneStateMonitor = {
|
||||
currentState: null,
|
||||
monitoringInterval: null,
|
||||
|
||||
// 开始监控电话状态
|
||||
startMonitoring() {
|
||||
this.checkPhoneState();
|
||||
|
||||
// 每2秒检查一次电话状态
|
||||
this.monitoringInterval = setInterval(() => {
|
||||
this.checkPhoneState();
|
||||
}, 2000);
|
||||
},
|
||||
|
||||
// 停止监控
|
||||
stopMonitoring() {
|
||||
if (this.monitoringInterval) {
|
||||
clearInterval(this.monitoringInterval);
|
||||
this.monitoringInterval = null;
|
||||
}
|
||||
},
|
||||
|
||||
// 检查电话状态
|
||||
checkPhoneState() {
|
||||
WebViewJavascriptBridge.callHandler('getphonestate', '', (phoneState) => {
|
||||
const newState = parseInt(phoneState);
|
||||
|
||||
if (newState !== this.currentState) {
|
||||
this.handleStateChange(this.currentState, newState);
|
||||
this.currentState = newState;
|
||||
}
|
||||
});
|
||||
},
|
||||
|
||||
// 处理状态变化
|
||||
handleStateChange(oldState, newState) {
|
||||
console.log(`电话状态变化: ${oldState} -> ${newState}`);
|
||||
|
||||
switch (newState) {
|
||||
case 0: // 空闲状态
|
||||
this.onPhoneIdle();
|
||||
break;
|
||||
case 1: // 响铃状态
|
||||
this.onPhoneRinging();
|
||||
break;
|
||||
case 2: // 通话中
|
||||
this.onPhoneInCall();
|
||||
break;
|
||||
}
|
||||
},
|
||||
|
||||
// 电话空闲时
|
||||
onPhoneIdle() {
|
||||
console.log('电话空闲，恢复游戏');
|
||||
this.resumeGame();
|
||||
this.restoreAudio();
|
||||
},
|
||||
|
||||
// 电话响铃时
|
||||
onPhoneRinging() {
|
||||
console.log('电话响铃，暂停游戏');
|
||||
this.pauseGame();
|
||||
this.muteAudio();
|
||||
},
|
||||
|
||||
// 通话中时
|
||||
onPhoneInCall() {
|
||||
console.log('通话中，保持游戏暂停');
|
||||
this.pauseGame();
|
||||
this.muteAudio();
|
||||
},
|
||||
|
||||
// 暂停游戏
|
||||
pauseGame() {
|
||||
// 暂停游戏逻辑
|
||||
const gameContainer = document.getElementById('gameContainer');
|
||||
if (gameContainer) {
|
||||
gameContainer.style.display = 'none';
|
||||
}
|
||||
|
||||
// 显示通话提示
|
||||
this.showCallNotification();
|
||||
},
|
||||
|
||||
// 恢复游戏
|
||||
resumeGame() {
|
||||
// 恢复游戏逻辑
|
||||
const gameContainer = document.getElementById('gameContainer');
|
||||
if (gameContainer) {
|
||||
gameContainer.style.display = 'block';
|
||||
}
|
||||
|
||||
// 隐藏通话提示
|
||||
this.hideCallNotification();
|
||||
},
|
||||
|
||||
// 静音音频
|
||||
muteAudio() {
|
||||
// 设置音效为关闭
|
||||
WebViewJavascriptBridge.callHandler('voicePlaying', '0', function(response) {
|
||||
console.log('音效已静音');
|
||||
});
|
||||
},
|
||||
|
||||
// 恢复音频
|
||||
restoreAudio() {
|
||||
// 恢复之前的音效设置
|
||||
WebViewJavascriptBridge.callHandler('voicePlaying', '1', function(response) {
|
||||
console.log('音效已恢复');
|
||||
});
|
||||
},
|
||||
|
||||
// 显示通话提示
|
||||
showCallNotification() {
|
||||
let notification = document.getElementById('callNotification');
|
||||
if (!notification) {
|
||||
notification = document.createElement('div');
|
||||
notification.id = 'callNotification';
|
||||
notification.className = 'call-notification';
|
||||
notification.innerHTML = `
|
||||
<div class="notification-content">
|
||||
<h3>通话中</h3>
|
||||
<p>游戏已暂停，通话结束后将自动恢复</p>
|
||||
</div>
|
||||
`;
|
||||
document.body.appendChild(notification);
|
||||
}
|
||||
notification.style.display = 'block';
|
||||
},
|
||||
|
||||
// 隐藏通话提示
|
||||
hideCallNotification() {
|
||||
const notification = document.getElementById('callNotification');
|
||||
if (notification) {
|
||||
notification.style.display = 'none';
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
// 页面加载时开始监控
|
||||
document.addEventListener('DOMContentLoaded', function() {
|
||||
PhoneStateMonitor.startMonitoring();
|
||||
});
|
||||
|
||||
// 页面卸载时停止监控
|
||||
window.addEventListener('beforeunload', function() {
|
||||
PhoneStateMonitor.stopMonitoring();
|
||||
});
|
||||
```
|
||||
|
||||
### HarmonyOS实现要点
|
||||
- **接口名称**: `getphonestate`
|
||||
- **调用方向**: WebView → App
|
||||
- **参数格式**: 空字符串
|
||||
- **权限要求**: 需要READ_PHONE_STATE权限
|
||||
- **状态值**: 返回0/1/2表示不同的通话状态
|
||||
|
||||
---
|
||||
|
||||
## 5. 游戏启动接口 (SwitchOverGameData)
|
||||
|
||||
### 接口概述
|
||||
启动指定的游戏应用或切换到其他游戏模块，支持传递启动参数和配置信息。
|
||||
|
||||
### 工作流程
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant User as 用户
|
||||
participant WebView as WebView
|
||||
participant App as App
|
||||
participant GameEngine as 游戏引擎
|
||||
participant GameModule as 游戏模块
|
||||
|
||||
User->>WebView: 选择游戏
|
||||
WebView->>App: 调用SwitchOverGameData接口
|
||||
App->>App: 解析游戏ID和参数
|
||||
App->>GameEngine: 初始化游戏引擎
|
||||
GameEngine->>GameModule: 加载指定游戏模块
|
||||
GameModule->>GameEngine: 返回加载状态
|
||||
GameEngine->>App: 游戏启动完成
|
||||
App->>WebView: 返回启动结果
|
||||
```
|
||||
|
||||
### 参数规范
|
||||
|
||||
#### 调用格式
|
||||
```javascript
|
||||
WebViewJavascriptBridge.callHandler('SwitchOverGameData', gameConfig, function(response) {
|
||||
console.log('游戏启动结果:', response);
|
||||
});
|
||||
```
|
||||
|
||||
#### 参数说明
|
||||
| 参数 | 类型 | 必需 | 说明 | 示例值 |
|
||||
|------|------|------|------|--------|
|
||||
| gameConfig | string | ✓ | 游戏配置信息 | "poker" 或 JSON配置字符串 |
|
||||
|
||||
### 接口调用示例
|
||||
|
||||
#### 启动扑克游戏
|
||||
```javascript
|
||||
function startPokerGame() {
|
||||
WebViewJavascriptBridge.callHandler('SwitchOverGameData', 'poker', function(response) {
|
||||
if (response === 'success') {
|
||||
console.log('扑克游戏启动成功');
|
||||
} else {
|
||||
showMessage('游戏启动失败，请重试');
|
||||
}
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
#### 带参数启动游戏
|
||||
```javascript
|
||||
function startGameWithParams(gameId, gameMode, playerCount) {
|
||||
const gameConfig = JSON.stringify({
|
||||
gameId: gameId,
|
||||
mode: gameMode,
|
||||
players: playerCount,
|
||||
timestamp: Date.now()
|
||||
});
|
||||
|
||||
WebViewJavascriptBridge.callHandler('SwitchOverGameData', gameConfig, function(response) {
|
||||
console.log('游戏启动配置已发送');
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
### HarmonyOS实现要点
|
||||
- **接口名称**: `SwitchOverGameData`
|
||||
- **调用方向**: WebView → App
|
||||
- **参数格式**: 游戏ID字符串或JSON配置
|
||||
- **游戏管理**: 需要游戏模块加载和切换机制
|
||||
- **错误处理**: 处理游戏启动失败的情况
|
||||
|
||||
---
|
||||
|
||||
## 6. 页面数据返回接口 (backgameData)
|
||||
|
||||
### 接口概述
|
||||
当子页面需要向上级页面传递数据时，通过此接口实现页面间的数据回传，常用于设置页面、选择页面等场景。
|
||||
|
||||
### 工作流程
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant ChildPage as 子页面
|
||||
participant App as App
|
||||
participant ParentPage as 父页面
|
||||
participant DataHandler as 数据处理器
|
||||
|
||||
ChildPage->>App: 调用backgameData接口
|
||||
App->>App: 接收返回数据
|
||||
App->>DataHandler: 解析数据格式
|
||||
DataHandler->>App: 验证数据完整性
|
||||
App->>ParentPage: 传递数据到父页面
|
||||
ParentPage->>ParentPage: 处理返回数据
|
||||
App->>ChildPage: 关闭子页面
|
||||
```
|
||||
|
||||
### 参数规范
|
||||
|
||||
#### 调用格式
|
||||
```javascript
|
||||
const returnData = {
|
||||
type: "settings",
|
||||
data: {
|
||||
username: "新用户名",
|
||||
avatar: "avatar_url"
|
||||
}
|
||||
};
|
||||
|
||||
WebViewJavascriptBridge.callHandler('backgameData', JSON.stringify(returnData), function(response) {
|
||||
console.log('数据返回成功');
|
||||
});
|
||||
```
|
||||
|
||||
#### 参数说明
|
||||
| 参数 | 类型 | 必需 | 说明 | 示例值 |
|
||||
|------|------|------|------|--------|
|
||||
| returnData | string | ✓ | JSON格式的返回数据 | JSON字符串 |
|
||||
|
||||
### 接口调用示例
|
||||
|
||||
#### 设置页面数据返回
|
||||
```javascript
|
||||
function saveSettingsAndReturn() {
|
||||
const settingsData = {
|
||||
type: "userSettings",
|
||||
data: {
|
||||
username: document.getElementById('username').value,
|
||||
avatar: document.getElementById('avatar').src,
|
||||
theme: document.querySelector('input[name="theme"]:checked').value,
|
||||
notifications: document.getElementById('notifications').checked
|
||||
},
|
||||
timestamp: Date.now()
|
||||
};
|
||||
|
||||
WebViewJavascriptBridge.callHandler('backgameData', JSON.stringify(settingsData), function(response) {
|
||||
console.log('设置已保存并返回');
|
||||
// 页面将被自动关闭
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
#### 游戏选择结果返回
|
||||
```javascript
|
||||
function selectGameAndReturn(gameId, gameMode) {
|
||||
const selectionData = {
|
||||
type: "gameSelection",
|
||||
data: {
|
||||
selectedGame: gameId,
|
||||
gameMode: gameMode,
|
||||
difficulty: document.getElementById('difficulty').value
|
||||
}
|
||||
};
|
||||
|
||||
WebViewJavascriptBridge.callHandler('backgameData', JSON.stringify(selectionData), function(response) {
|
||||
console.log('游戏选择已确认');
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
### HarmonyOS实现要点
|
||||
- **接口名称**: `backgameData`
|
||||
- **调用方向**: WebView → App
|
||||
- **参数格式**: JSON字符串格式的数据
|
||||
- **页面管理**: 数据传递后通常会关闭当前页面
|
||||
- **数据验证**: 需要验证返回数据的格式和完整性
|
||||
|
||||
---
|
||||
|
||||
## 文档关联
|
||||
|
||||
本文档是TSGame JSBridge接口规范的第二部分，完整文档包括：
|
||||
|
||||
1. **用户认证与页面管理** - 登录、页面跳转、语音控制
|
||||
2. **系统功能与交互** (本文档) - 剪贴板、游戏状态、设备检测
|
||||
3. **位置与媒体服务** - GPS定位、音频播放
|
||||
|
||||
---
|
||||
|
||||
**文档维护**: TSGame开发团队
|
||||
**最后更新**: 2025年7月13日
|
||||
**版本**: v1.9
|
||||
**联系方式**: 技术支持组
|
||||
Reference in New Issue
Block a user