# PCMPlayer

**Repository Path**: amlinsan/pcmplayer

## Basic Information

- **Project Name**: PCMPlayer
- **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-09-13
- **Last Updated**: 2025-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Android, audio, pcm, media

## README

# PCM Audio Player for Android

一个简单易用的Android PCM音频播放器应用。

## 功能特点

- 支持播放PCM原始音频文件
- 可自定义音频参数（采样率、声道数、位深度）
- 播放控制（播放、暂停、停止）
- 音量调节
- 进度显示
- 文件选择器

## 支持的音频参数

### 采样率
- 8000 Hz
- 11025 Hz
- 16000 Hz
- 22050 Hz
- 44100 Hz (默认)
- 48000 Hz
- 96000 Hz
- 192000 Hz

### 声道
- 单声道（Mono）
- 立体声（Stereo）- 默认

### 位深度
- 8-bit
- 16-bit (默认)
- 32-bit

## 构建方法

### 使用Android Studio

1. 打开Android Studio
2. 选择"Open an existing project"
3. 选择PCMPlayer文件夹
4. 等待Gradle同步完成
5. 点击运行按钮或使用Build > Build APK

### 使用命令行

```bash
cd PCMPlayer

# Windows
gradlew.bat assembleDebug

# Linux/Mac
./gradlew assembleDebug
```

构建完成后，APK文件位于：
`app/build/outputs/apk/debug/app-debug.apk`

## 安装和使用

1. 将APK文件传输到Android设备
2. 在设备上安装APK（需要允许安装未知来源应用）
3. 打开应用
4. 设置音频参数（采样率、声道、位深度）
5. 点击"Select PCM File"选择PCM文件
6. 点击"Play"开始播放

## 权限要求

- 读取外部存储权限（用于访问PCM文件）
- Android 11及以上需要管理外部存储权限

## 注意事项

- PCM文件为原始音频数据，没有文件头信息
- 需要正确设置音频参数才能正常播放
- 如果播放出现噪音或速度异常，请检查音频参数设置

## 项目结构

```
PCMPlayer/
├── app/
│   ├── src/main/java/com/example/pcmplayer/
│   │   ├── MainActivity.java      # 主界面
│   │   ├── PCMPlayer.java        # PCM播放器核心
│   │   └── FileUtils.java        # 文件处理工具
│   ├── src/main/res/
│   │   ├── layout/
│   │   │   └── activity_main.xml # 主界面布局
│   │   └── values/
│   │       └── strings.xml       # 字符串资源
│   └── AndroidManifest.xml       # 应用配置
├── build.gradle                   # 项目构建配置
└── settings.gradle               # 项目设置
```