# BluetoothMusicControl

**Repository Path**: FanMession/bluetooth-music-control

## Basic Information

- **Project Name**: BluetoothMusicControl
- **Description**: 手机控制另一个手机音乐按钮 上一曲下一曲暂停
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-19
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bluetooth Music Control App

这是一个安卓应用，可以通过蓝牙连接两台手机，实现一台手机控制另一台手机的音乐播放。

## 功能特点

- 蓝牙设备扫描和配对
- 蓝牙客户端-服务器通信
- 音乐播放控制（上一曲、下一曲、播放/暂停）
- 支持两台手机互相控制

## 使用方法

### 步骤1：启动应用
在两台安卓手机上安装并启动应用。

### 步骤2：开启蓝牙
确保两台手机的蓝牙功能都已开启。

### 步骤3：建立连接

#### 方法A：一台作为服务器，另一台作为客户端
1. 在其中一台手机上点击"启动服务器"按钮
2. 在另一台手机上点击"扫描设备"
3. 从设备列表中选择服务器设备，点击连接

#### 方法B：两台设备互相发现并连接
1. 两台设备都点击"扫描设备"
2. 从设备列表中选择对方设备，点击连接

### 步骤4：控制音乐
连接成功后，你可以使用界面上的按钮控制对方手机的音乐：
- 上一曲：播放上一首歌曲
- 播放/暂停：切换播放状态
- 下一曲：播放下一首歌曲

## 技术实现

### 蓝牙通信
- 使用经典蓝牙（Bluetooth Classic）进行通信
- 采用客户端-服务器架构
- UUID：00001101-0000-1000-8000-00805F9B34FB

### 音乐控制
- 通过AudioManager发送媒体按键事件
- 支持主流音乐播放器

### 权限要求
- BLUETOOTH：蓝牙基本功能
- BLUETOOTH_ADMIN：蓝牙设备管理
- BLUETOOTH_CONNECT：连接蓝牙设备
- BLUETOOTH_SCAN：扫描蓝牙设备
- ACCESS_FINE_LOCATION：位置权限（用于蓝牙扫描）
- MEDIA_CONTENT_CONTROL：媒体控制权限

## 开发环境

- Android Studio
- Android SDK 34
- Minimum SDK 26

## 构建和运行

1. 使用Android Studio打开项目
2. 连接安卓设备或启动模拟器
3. 构建并运行应用

## 注意事项

1. 确保两台设备在蓝牙有效范围内（通常10米内）
2. 确保被控制设备上有音乐播放器在运行
3. 某些音乐播放器可能需要在前台才能被控制
4. 首次使用时需要授予必要的权限

## 故障排除

- 如果无法发现设备：检查蓝牙是否开启，位置权限是否已授予
- 如果无法连接：确保设备已配对，尝试重新启动蓝牙
- 如果控制无效：确保被控制设备上有音乐在播放，尝试切换音乐播放器

## 版本历史

- v1.0：初始版本，实现基本蓝牙连接和音乐控制功能