Titanium SDK 音频播放器(AudioPlayer)深度解析与应用指南

Titanium SDK 音频播放器(AudioPlayer)深度解析与应用指南

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk

概述

Titanium.Media.AudioPlayer 是 Titanium SDK 中用于流式音频播放的核心组件，它提供了对音频播放的低级控制能力。开发者可以通过这个模块实现网络音频流播放、本地音频文件播放以及各种播放控制功能。

核心功能

基础播放控制

AudioPlayer 提供了完整的播放控制方法：

• start(): 开始或恢复播放
• pause(): 暂停播放（iOS上作为开关使用）
• stop(): 停止播放
• restart(): 重新开始播放（7.5.0+）
• seekToTime(time): 跳转到指定时间位置（7.5.0+）

状态管理

播放器有多种状态，可以通过事件监听状态变化：

audioPlayer.addEventListener('change', function(e) {
    console.log('播放状态:', e.description);
});

资源管理

特别需要注意的是资源释放：

// 使用完毕后必须调用release释放资源
audioPlayer.release();

平台差异与注意事项

Android 平台

1. 后台播放：需要设置 allowBackground: true 才能实现后台播放
2. 资源释放：必须显式调用 release() 方法
3. 音频类型：支持设置不同的音频流类型（AUDIO_TYPE_*）

iOS 平台

1. 音频会话：可以通过 Titanium.Media.audioSessionCategory 控制音频行为
2. 现代API：7.5.0+ 版本使用 AVPlayer API 实现，性能更优
3. 外部播放：支持 AirPlay 等外部播放功能（allowsExternalPlayback）

实战示例

基础音频播放器实现

// 创建音频播放器
var player = Ti.Media.createAudioPlayer({
    url: 'http://example.com/audio.mp3',
    allowBackground: true // Android后台播放
});

// 播放控制
function togglePlayback() {
    if (player.playing) {
        player.pause();
    } else {
        player.start();
    }
}

// 进度监听
player.addEventListener('progress', function(e) {
    console.log('当前进度:', e.progress);
});

// 播放完成
player.addEventListener('complete', function(e) {
    if (e.success) {
        console.log('播放完成');
    } else {
        console.error('播放出错:', e.error);
    }
});

高级功能实现

// 跳转播放位置
function seekToPosition(seconds) {
    player.seekToTime(seconds * 1000);
}

// 监听跳转完成
player.addEventListener('seek', function(e) {
    console.log('跳转' + (e.finished ? '完成' : '被中断'));
});

// 设置播放速率
player.rate = 1.5; // 1.5倍速播放

最佳实践

1. 资源管理：始终在不再需要时调用 release() 方法
2. 错误处理：监听 error 事件处理播放异常
3. 状态检查：通过 playing 和 paused 属性检查当前状态
4. 后台播放：Android 需要明确设置 allowBackground
5. 跨平台兼容：优先使用统一API（如 start() 而非 play()）

常见问题

1. Q: 为什么我的音频在Android后台不能播放？ A: 需要设置 allowBackground: true 属性

2. Q: 如何实现循环播放？ A: 监听 complete 事件并再次调用 start()

3. Q: 为什么seek操作不精确？ A: 网络流媒体的seek精度取决于服务器支持，本地文件更精确

4. Q: iOS上如何控制与其他音频的混音行为？ A: 通过 Titanium.Media.audioSessionCategory 设置音频会话类别

通过本文的详细介绍，开发者应该能够全面掌握 Titanium.Media.AudioPlayer 的使用方法，并在实际项目中实现各种音频播放需求。

titanium-sdk 🚀 Native iOS and Android Apps with JavaScript 项目地址: https://gitcode.com/gh_mirrors/ti/titanium-sdk