mpg123(1)

命令名
mpg123 - 播放 MPEG 1.0/2.0 Layer-1, -2, -3 音频文件

语法
mpg123 [ -tscvqy01m24 ][ -b size ][ -k num ][ -n num ][ -f factor ][ -r rate ][ -g gain ][ -a dev ][ -o s | -o h | -o l ][ -d n ][ -h n ][ -p proxy ][ -@ file ] file ... | URL ... | -

描述
mpg123 从一个或多个 文件 或者 URL 读取MPEG-1/2音频比特流 (如果指定 `-' 选项, 则从标准输入读取), 然后使用音频设备进行播放(默认), 或将解码结果送 到标准输出上.

选项
mpg123 接收传统的POSIX风格的单字母选项, 也接收GNU风格的长单词选项. 这两 种选项分别以 `-' 和 "--" 开头.

-t, --test
    测试模式. 对音频流进行解码, 但不输出.

-s, --stdout
    将解码结果送到标准输出上, 而不使用音频设备进行播放. 如果 mpg123 不支持你的音频硬件, 你就可以试试这一选项, 这时, mpg123 以本机 字节顺序(host byte order)输出16比特的立体声线性PCM(脉冲编码调制) 音频裸数据(没有数据头).

-c, --check
    对每一帧进行滤波器越界检查, 如发生则报告之.

-v, --verbose
    播放时显示更多信息, 比如显示当前正在解码的帧号.

-q, --quiet
    安静模式. 不显示诊断信息.

-y, --resync
    如果输入文件发生错误, 则重新进行同步并继续解码. 另外, 对那些文件 头损坏的MPEG文件, 通常 mpg123 会拒绝播放并显示 ' Illegal header', 但如果指定本选项, mpg123 会试图从损坏的文件头中恢复并进行播放. 小心: 损坏的MPEG文件在播放到损坏处时可能出现尖利刺耳的噪声, 如果 音量过大, 可能损坏扬声器.

-0, --single0; -1, --single1
    只对0(左) 声道或者1(右) 声道进行解码. 这两个选项只对立体声的MPEG 音频流有效.

-m, --singlemix
    将两个声道混音. 此选项只对MPEG Layer-3的立体声音频流有效, 并可比 完全立体声解码节省一些 CPU时间.

-2, --2to1; -4, --4to1
    将输出流的采样率将低至标准的1/2 (22kHz) 或者1/4 (11kHz). 使用这 两个选项可以减少一些CPU的负荷, 但是声音质量会下降(至少使用11kHz 采样率时会很难听).

-b size, --buffer size
    用 size 指定输出缓冲区的大小, 单位为千字节. 使用此选项通常可以避 免由频繁的系统操作造成的 声音输出时断时续的现象. size 的值小于 300时就没什么意义了, 建议至少取1024(即使用1Mb的缓冲区, 可以缓冲 相当于6秒钟的音频数据). size 的默认值为0, 即不进行输出缓冲.

-k num, --skip num
    跳过前 num 帧. 不指定此选项时, 默认从第1帧开始解码.

-n num, --frames num
    只对前 num 帧进行解码. 不指定此选项时, 默认对整个音频流进行解码.

-f factor, --scale factor
    改变缩放因子 factor 的值(默认值为32768).

-r rate, --rate rate
    设置采样率 rate (默认为自动设置). 使用这一选项后, mpg123 会自动 将速率转换成不依赖于MPEG流速率的一个恒定比特率. 此选项应该和 --stereo 或 --mono 联合起来使用.

-g gain, --gain gain
    设置音频硬件输出增益 gain (默认为保持不变).

-a dev, --audiodevice dev
    指定音频设备. 默认的音频设备与系统配置有关(通常是 /dev/audio 或 /dev/dsp ), 如果系统中有多个音频设备而默认的又不是你想用的那个, 就可使用本选项.

-o s, --speaker
    将声音导出到主板上的扬声器上.

-o h, --headphones
    将声音导出到耳机连接器上.

-o l, --lineout
    将声音导出到Line-Out连接器上.

-d n, --doublespeed n
    每 n 帧播放一帧. 这会使MPEG流的播放速度提高为正常速度的 n 倍, 从而可以产生特殊的声音效果. 此选项可以和 --halfspeed 选项组合使 用, 实现类似每4帧播放3帧(译者注: 指定-d 4 -h 3)的效果. 如果使用 此选项, 不要指望声音质量会很好.

-h n, --halfspeed n
    将每帧都播放 n 遍. 这会使MPEG流的播放速度降低为正常速度的 1/n, 从而可以产生特殊的声音效果. 此选项可以和 --doublespeed 选项组合 使用, 实现类似每3帧播放2帧(译者注: 指定-h 2 -d 3)的效果. 如果使 用此选项, 不要指望声音质量会很好.

-p URL | none, --proxy URL | none
    指定 proxy 作为HTTP请求的代理. 指定的格式应是一个完整的URL (如"http://host.domain:port/"), 但是可以省略前缀"http://", 端口 号port(默认的端口为80)和末尾的'/'. 如果指定为 none ,则不使用代 理, 直接向服务器请求文件. 更多细节请看 "HTTP 支持" 小节.

-u auth, --auth auth
    如果通过HTTP下载文件时服务器要求提供认证信息, 则由 auth 指定, 其 格式为 "用户名:密码" (不包括引号).

-@ file, --list file
    从 file 指定的文件中读取将要播放的MPEG音频流所在的文件和(或)URL, 如果 命令行中还指定了其它的文件和(或)URL, 也将其包含进播放清单. 如果指定 file 为 `-'而非一个普通的文件名, mpg123 将从标准输入读 取文件名和(或)URL, 或者读取一个指向播放清单文件的URL. 注意: -@ 选项只能使用一次(如果多处指定, 则只有最后一个有效).

-z, --shuffle
    随机播放. 按随机的顺序播放命令行和清单文件中指定的音频文件.

--stereo
    强制立体声输出.

--reopen
    强制在播放完一个文件后重新打开音频设备.

--8bit
    强制8比特输出.

-Z, --random
    完全随机播放. (译者注: 与 --shuffle 选项的区别是, 指定本选项有可 能重复多次播放同一文件)

操作数
mpg123 支持下面的操作数:

file
    指定输入文件的路径. 这些文件必须包含合法的MPEG-1/2音频 Layer-1, Layer-2或Layer-3的比特流. 如果指定为'-', 将从标准输入读取MPEG数 据. 进一步, 如果以"http://"开头, 则认为指定 了一个 URL (请看下一 节).

HTTP 支持
除了能从普通文件和标准输入读取MPEG音频流, mpg123 还支持通过HTTP协 议从万 维网(WWW)上获取由URL(统一资源定位符)指定的文件. 一个URL是一个以 "http://" 为前缀的字符串, 当 mpg123 识别到这个前缀, 它会尝试开启一个 到相应服务器的连接, 接着获取相应的文件并进行解码播放.

很多时候, 从WWW缓存, 或所谓的网络代理比直接从服务器更容易获取文件. 为利 用这种便利, mpg123 会依次检查 MP3_HTTP_PROXY, http_proxy和HTTP_PROXY, 这三个环境变量是否被设置, 并将第一个被设置的变量的值作为指定的代理. 如 果你需要自己指定另外的代理, 可以使用 -p 命令行选项 (请看"选项"小节). 使用 -p none 选项将不使用任何代理而直接连接服务器, 即使前面所述的三个 变量被设置.

值得注意的是, 为了能从一个WWW服务器获取并流畅地播放MPEG音频文件, 必须有 足够快的网络连接. 例如, 为了能播放速率为128kbit/s的MPEG文件, 所需的 网络带宽至少应该是128kbit/s加上网络协 议本身的传输开销. 如果网络常发生 短时中断, 可以试试用 -b 选项指定一个缓冲区. 如果你所在的网络根本无 法达到实时传输MPEG音频文件所需的带宽, 就只好使用 lynx(1) 之类的软件先将 文件下载到本地硬盘上再进行播放了.

如果服务器要求认证, 可以使用 -u auth 选项(请看"选项"小节)指定用户名和密 码.

中断
任何时候按Ctrl-C键都能中断 mpg123 的运行. 如果有多个文件在播放, Ctrl-C 会终止当前文件的播放并 开始播放下一个文件, 这种情况下, 如果你想终止整 个程序的运行, 必须连按两次Ctrl-C (在约一秒钟之内).

注意, 按了Ctrl-C之后声音也许不会马上消失, 这是因为系统的音频设备缓冲了 一部分数据. 这种延迟随系统不同而不同, 但通常都不超过1到2秒.

相关说明
lynx(1), sox(1), intro(1)

注意
MPEG音频解码, 特别是Layer-3的解码, 需要CPU进行大量的运算. 为能达到实时 解码, 你的计算机至少应该配备Pentium, Alpha, SuperSparc或性能相当的处 理器. 同时你可以使用 -singlemix 选项进行单声道解码, 对Layer-3, 这多少 能减少一点CPU负荷. 此外你也可以考虑使用 -2 和 -4 选项.

如果这些方法都不奏效, 试试用 -s 选项将解码结果送到标准输出上并将其定向 到一个文件中, 然后再用适当的工具播放这个文件. 你也许会用到 sox(1) 这个 工具, 它能将文件转换成你的音频播放器所用的格式.

还有一点就是 mpg123 总是输出16比特的立体声数据(如果指定 -0或-1 选项中 的一个, 立体声两个声道的数据是相同的). 如果系统硬件要求其它格式, 比如8 比特的单声道的数据, 同样可以使用 sox(1) 进行转化.

如果你的系统本身足够快, 能够进行实时解码, 只是在系统负荷较重时(如定时任 务, 用户远程登录或启动`大'程序等)出现停顿, 你应该用 -b 选项指定一个不小 于1000K字节的缓冲区.

BUGS

已知的BUG和局限性:
    MPEG-2, Layer-1和-2未经 测试. 可能不能工作.(Layer-3应该能工作.)
    不提供对自由格式的音频流的支持.
    对Layer-1的支持未经 严格测试.
    未进行CRC错误校验.
    没有对DEC Digital Unix, Ultrix 和 IBM AIX平台上的音频硬件提供支 持, 因此在这些平台上必须使用 -s 选项.

作者

主要作者:
    Michael Hipp <hippm@informatik.uni-tuebingen.de>

使用了下面的代码或借鉴了其中的思想:
    MPEG Software Simulation Group (Base package)
    Philipp Knirsch <phil@mpik-tueb.mpg.de> (DCT36/manual unroll)
    Tobias Bading <bading@cs.tu-berlin.de> (subband synthesis)
    Jeff Tsay <ctsay@pasteur.eecs.berkeley.edu> (DCT36)
    Thomas Woerner (SGI Audio)
    Damien Clermonte <clermond@esiee.fr> (HP-UX audio fixes)
    Oliver Fromme <oliver.fromme@heim3.tu-clausthal.de>

网络参考资料: http://www.sfs.nphil.uni-tuebingen.de/~hipp/mpg123.html
http://www.heim3.tu-clausthal.de/~olli/mpg123/
(包含关于mpg123邮件组的信息)

在此获取最新版本:
http://ftp.tu-clausthal.de/pub/unix/audio/mpg123

[中文版维护人]
linuxipy <groove@ustc.edu>

[中文版最新更新]
2004/2/29

《中国linux论坛man手册页翻译计划》:
http://cmpp.linuxforum.net