贝利信息

如何获取网络音频流的 MIME 类型与码率信息

日期:2026-01-02 00:00 / 作者:心靈之曲

通过向音频流 url 发起轻量级 fetch 请求并读取 http 响应头,可在不下载完整音频的前提下获取 content-type(如 audio/mpeg)和 icecast 自定义头 icy-br,从而实时显示音频格式与码率。

在 Web 广播播放场景中,原生 元素本身不暴露流式响应的 HTTP 头信息(如 Content-Type 或 icy-br),因此无法直接通过 audio 实例获取音频类型或码率。但我们可以利用 fetch() 的流式能力,在连接建立后立即中止请求,仅读取响应头——这既高效又低开销。

以下是一个健壮的模块化实现:

// ObtainStreamHeaders.js
export default function obtainStreamHeaders(src) {
  return new Promise((resolve, reject) => {
    const controller = new AbortController();
    const timeoutId = setTimeout(() => controller.abort(), 5000); // 5秒超时保护

    fetch(src, {
      method: 'HEAD', // 优先使用 HEAD,避免传输响应体
      signal: controller.signal,
      headers: {
        // 部分 Icecast 服务器需显式允许跨域头(若同源可省略)
        'Accept': '*/*',
      }
    })
      .then(response => {
        clearTimeout(timeoutId);
        const headers = Object.fromEntries(response.headers.entries());
        resolve(headers);
      })
      .catch(err => {
        clearTimeout(timeoutId);
        reject(err.name === 'AbortError' ? new Error('Request timed out or aborted') : err);
      });
  });
}

使用方式(配合播放器):


Format: 
Bitrate: 
import obtainStreamHeaders from './ObtainStreamHeaders.js';

const audio = document.getElementById('radio-player');
audio.addEventListener('playing', () => {
  obtainStreamHeaders(audio.src)
    .then(headers => {
      // 解析 MIME 类型(标准化显示)
      const mimeType = headers['content-type']?.split(';')[0].trim() || 'unknown';
      const mimeLabel = {
        'audio/mpeg': 'MP3',
        'audio/ogg': 'OGG',
        'audio/aac': 'AAC',
        'audio/mp4': 'AAC (MP4)',
        'audio/flac': 'FLAC'
      }[mimeType] || mimeType;

      document.getElementById('mime').textContent = mimeLabel;

      // 解析 Icecast 码率(单位 kbps)
      const br = headers['icy-br'] ? `${parseInt(headers['icy-br'], 10)} kbps` : 'unknown';
      document.getElementById('br').textContent = br;
    })
    .catch(err => {
      console.warn('Failed to fetch stream headers:', err);
      document.getElementById('mime').textContent = 'unknown';
      document.getElementById('br').textContent = 'unknown';
    });
});

// 启动播放
audio.src = 'https://some-radio-station.com/stream';
audio.load(); // 显式调用 load() 确保 readyState 更新

关键优化点说明:

⚠️ 局限性提示:

综上,该方案以最小侵入性实现了 Web 广播元信息的实时呈现,兼顾性能、兼容性与可维护性,是生产环境推荐实践。