# louyingche

**Repository Path**: learningxm/louyingche

## Basic Information

- **Project Name**: louyingche
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-19
- **Last Updated**: 2025-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 引入插件

```
const TCPSocket = uni.requireNativePlugin("TCP-Socket");
```

---

### 连接

##### 创建TCP连接

```
TCPSocket.connect({
	host: '192.168.1.1',
	port: 8888
}, res => {
	uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});
```
#### 参数说明

| **参数名** | **类型** | **必填** | **说明** |
|:------|:-------|:-------:|:------|
| host | String | 是 | 主机地址 |
| port | String | 是 | 主机端口 |
| timeout | Number | 否 | 超时时间，单位毫秒，默认：30000 |

#### 响应参数说明

| **参数名** | **类型** | **必填** | **说明** |
|:------|:-------|:-------:|:------|
| code | Number | 是 | 状态码，成功：200，失败：400 |
| message | String | 否 | 失败原因 |

---

### 连接状态

#### 获取TCP连接状态

```
TCPSocket.isConnected(status => {
	uni.showToast({ title: '响应数据：' + status, icon: 'none' });
});
```
#### 响应参数说明

| **参数名** | **类型** | **必填** | **说明** |
|:------|:-------|:-------:|:------|
| status | Boolean | 是 | 状态 |

---

### 断开连接

#### 断开TCP连接

```
TCPSocket.disconnect(res => {
	uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});
```

#### 响应参数说明

| **参数名** | **类型** | **必填** | **说明** |
|:------|:-------|:-------:|:------|
| code | Number | 是 | 状态码，成功：200，失败：400 |
| message | String | 否 | 失败原因 |

---

### 监听消息

#### 监听服务端响应消息

```
TCPSocket.message({
	// 如果不设置参数，此处必须保留空对象
	charsetName: 'GBK'
}, res => {
	uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});
```

#### 参数说明

| **参数名** | **类型** | **必填** | **说明** |
|:------|:-------|:-------:|:------|
| charsetName | String | 否 | 字符，默认UTF-8，可选：GBK，HEX |

#### 响应参数说明

| **参数名** | **类型** | **必填** | **说明** |
|:------|:-------|:-------:|:------|
| code | Number | 是 | 状态码，成功：200，失败：400 |
| data | String | 否 | 服务端响应的消息 |
| message | String | 否 | 失败原因 |

---

### 发送文本

#### 向服务端发送普通文本消息

```
TCPSocket.send('abcd123', res => {
	uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});
```

#### 响应参数说明

| **参数名** | **类型** | **必填** | **说明** |
|:------|:-------|:-------:|:------|
| code | Number | 是 | 状态码，成功：200，失败：400 |
| message | String | 否 | 失败原因 |

---

### 发送Hex

#### 向服务端发送16进制消息

```
TCPSocket.sendHex(['0C', '62', '06', '0A', 'D7', '3C'], res => {
	uni.showToast({ title: '响应数据：' + JSON.stringify(res), icon: 'none' });
});
```

#### 响应参数说明

| **参数名** | **类型** | **必填** | **说明** |
|:------|:-------|:-------:|:------|
| code | Number | 是 | 状态码，成功：200，失败：400 |
| message | String | 否 | 失败原因 |