# Flutter-JL_Home

**Repository Path**: Jieli-Tech/Flutter-JL_Home

## Basic Information

- **Project Name**: Flutter-JL_Home
- **Description**: No description available
- **Primary Language**: Dart
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-07
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[tag download]:https://github.com/Jieli-Tech/Flutter-JL_Home/tags
[tag_badgen]:https://img.shields.io/github/v/tag/Jieli-Tech/Flutter-JL_Home?style=plastic&logo=flutter&labelColor=ffffff&color=informational&label=Tag&logoColor=blue

# Flutter-JL_Home  [![tag][tag_badgen]][tag download]

<div align="center">
**杰理之家Demo(Flutter) - 专为杰理音箱耳机类产品提供蓝牙控制开发平台**

[中文](./README.md) · [English](./README_EN.md) · [文档中心](./doc/) · [SDK 版本历史](#八版本历史) · [报告问题](https://github.com/Jieli-Tech/Flutter-JL_Home/issues)

</div>

---

## 📋 目录

- [一、概述](#一概述)
- [二、运行环境](#二运行环境)
- [三、快速开始](#三快速开始)
- [四、工程结构](#四工程结构)
- [五、配置说明](#五配置说明)
- [六、调试技巧](#六调试技巧)
- [七、社区与支持](#七社区与支持)
- [八、版本历史](#八版本历史)
- [九、许可证](#九许可证)

---



## 一、概述

`Flutter-JL_Home` 是**珠海市杰理科技股份有限公司**为杰理音箱耳机类产品提供的蓝牙控制开发平台。本 SDK 基于<strong style="color:red">RCSP协议(远程控制系统协议)</strong>，提供完整的蓝牙控制功能和丰富的应用示例，支持以下应用场景：

| 应用类型 | 典型产品 |
|---------|---------|
| **音箱类产品** | 智能音箱、蓝牙音箱、便携音箱、Auracast音箱 |
| **耳机类产品** | TWS耳机、头戴式耳机、挂脖耳机、彩屏仓、翻译耳机 |
| **音频设备** | 蓝牙音频接收器、音频解码器、声卡、录音笔 |

**杰理之家Demo(Flutter)**提供了丰富的功能接口：

| 功能           | 说明                                                     |
| -------------- | -------------------------------------------------------- |
| **音乐控制**   | 手机音乐播放控制、设备音乐播放控制、ID3音乐信息显示      |
| **设备设置**   | 音量设置、状态查询、重启设备等                           |
| **文件浏览**   | 查看SD卡、U盘等存储器的音乐文件列表                      |
| **闹钟管理**   | 闹钟的增删改查, 闹钟铃声设置                             |
| **FM控制**    | FM收音功能                            |
| **灯光控制**   | 灯光闪烁, 频率, 颜色(RGB), 模式等控制, 实现酷炫效果      |
| **音效调节**   | 均衡器音效调节, 轻易打造卓越音质、 混响、高低音设置      |
| **按键设置**   | 耳机按键功能设置, 丰富耳机功能                           |
| **查找设备**   | 查找设备                                      |
| **ANC设置**   | 噪声处理模式设置, 支持正常模式、主动降噪模式、通透模式等 |
| **彩屏仓控制** | 亮度调节，屏幕保护程序更新                   |
| **AI翻译**    | 同声传译，面对面翻译             |
| **自定义命令** | 支持客户拓展功能                                         |

---



## 二、运行环境

| 类别 | 要求 | 说明 |
|------|------------|-----------|
| **操作系统** | Android 6.0+、IOS 13.0+ | 支持BLE功能 |
| **硬件要求** | 支持RCSP功能的SDK | AC701N、AC707N、AC697N、AC696N、AC695N等 |
| **开发平台** | Android Studio(支持Flutter) | 建议使用最新版 |
| **语言支持** | Dart/Kotlin/Swift | 提供完整的API支持 |





---

## 三、快速开始

### 3.1 克隆仓库

```bash
git clone https://github.com/Jieli-Tech/Flutter-JL_Home.git
cd Flutter-JL_Home
```



### 3.2 导入项目到Android Studio

1. 打开 Android Studio
2. 选择 "Open an existing project"
3. 导航到解压后的 `code/` 目录
4. 打开 `JieLi_Home_Demo`  中的项目文件



### 3.3 插件引用

```pubspec.yaml
  plugin:
    platforms:
      android:
        package: com.jieli.bt.sdk
        pluginClass: JlHomePlugin
      ios:
        pluginClass: JlHomePlugin
```


### 3.4 运行示例应用

运行项目到Android或者IOS设备，即可使用各项测试功能验证SDK集成效果。

---



## 四、工程结构

```
Flutter-JL_Home/
├── code/                                    # 参考源码工程文件夹
│   └── JieLi_Home_Demo                      # 杰理之家Demo(Flutter)项目源码
├── doc/                                     # 文档文件夹
│   ├── Jieli Home Demo (Flutter) - Send/Receive Interface Introduction_en.md   # 英文文档
│   ├── Jieli Home Demo (Flutter) - Send/Receive Interface Introduction.md      # 中文文档
│   └── ReadMe.txt                           # 说明文件
└── libs/                                    # 核心收发接口文件夹
    ├── Receive Interface                    # 杰理之家Demo(Flutter)的接收接口
    └── Send Interface                       # 杰理之家Demo(Flutter)的发送接口
```

---



## 五、配置说明

### 5.1 杰理之家Demo(Flutter) (`code/JieLi_Home_Demo/`)

| 项目 | 说明 |
|------|------|
| **适用场景** | 完整的音箱/耳机控制 App，支持多媒体、音效、设备管理 |
| **关键特性** | 卡拉 OK、音效调节、多语言、HTTP 接口、OTA 升级 |
| **参考文档** | [SDK 接入文档](./doc/) |

---

## 六、调试技巧

- **日志输出**：SDK 内置详细日志，可实时监控蓝牙连接状态及数据交互全过程，便于快速定位问题。

- **日志查看方式**：
  - **Android**：使用 Android Studio 的 Logcat 工具查看实时日志。
  - **iOS**：使用 Xcode 的 Console（控制台）查看实时日志。

- **问题排查**：
  - **Android SDK**：详见 [Android SDK 调试说明](https://doc.zh-jieli.com/Apps/Android/jielihome/zh-cn/master/other/debug.html)
  - **iOS SDK**：详见 [iOS SDK 调试说明](https://doc.zh-jieli.com/Apps/iOS/jielihome/zh-cn/master/Other/debug.html)
---



## 七、社区与支持

### 7.1 技术交流

| 平台 | 联系方式 | 状态 |
|------|----------|------|
| **官方网站** | [杰理科技](https://www.zh-jieli.com/) | ✅ 活跃 |
| **GitHub Issues** | [问题反馈](https://github.com/Jieli-Tech/Flutter-JL_Home/issues) | ✅ 活跃 |



### 7.2 资源链接

| 资源 | 链接 |
|------|------|
| 📄 **数据手册** | [开发说明文档](./doc/) |
| 📚 **版本历史** | [版本历史](#八版本历史) |
| 🐛 **问题反馈** | [GitHub Issues](https://github.com/Jieli-Tech/Flutter-JL_Home/issues) |

---



## 八、版本历史

| 版本 | 日期 | 修改记录 |
|------|------|----------|
| 1.0.0 | 2026/07/02 | 初始版本|
---



## 九、许可证

本项目采用 [Apache License 2.0](./LICENSE) 开源协议。

```
Copyright 2024 珠海市杰理科技股份有限公司

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

<div align="center">
**© 2024 珠海市杰理科技股份有限公司 | Licensed under Apache License 2.0**
</div>