PhoneGap API帮助文档翻译—Media（媒体）

Media对象提供录制和回放设备上的音频文件的能力。

var media = new Media(src, mediaSuccess, [mediaError]);

复制代码

备注：Media的当前实现并没有遵守W3C媒体捕获的相关规范，目前只是为了提供方便。未来的实现将遵守最新的W3C规范并可能不再支持当前的APIs。

参数：

src：一个包含音频内容的URI。（DOMString类型）
mediaSuccess：（可选项）当一个Media对象完成当前的播放、录制或停止操作时触发的回调函数。（函数类型）
mediaError：（可选项）当出现错误时调用的回调函数。（函数类型）
mediaStatus：（可选项）当状态发生变化的时候调用的回调函数。（函数类型）

方法：

media.getCurrentPosition：返回一个音频文件的当前位置。
media.getDuration：返回一个音频文件的总时长。
media.play：开始或恢复播放音频文件。
media.pause：暂停播放音频文件。
media.release：释放底层操作系统的音频资源。
media.seekTo：在音频文件中移动到相应的位置。
media.startRecord：开始录制音频文件。
media.stopRecord：停止录制音频文件。
media.stop：停止播放音频文件。

另外的只读属性：

_position：以秒为单位的音频播放位置，播放过程中不会自动更新，通过调用getCurrentPosition进行更新。
_duration：以秒为单位的媒体时长。

支持的平台：

Android
iOS

media.getCurrentPosition

返回返回一个音频文件的当前的位置。

media.getCurrentPosition(mediaSuccess, [mediaError]);

复制代码

参数：

mediaSuccess：成功的回调函数，返回当前的位置。
mediaError：（可选项）如果发生错误时调用的回调函数。

说明：media.getCurrentPosition是一个异步函数，用户返回一个Media对象所指向的音频文件的当前位置，同时会对Media对象的_position参数进行更新。

支持的平台：

Android
iOS

简单的范例：

// 音频播放器
var my_media = new Media(src, onSuccess, onError);
// 每秒更新一次媒体播放到的位置
var mediaTimer = setInterval(function() {
// 获得媒体位置
my_media.getCurrentPosition(
// 获得成功后调用的回调函数
function(position) {
if (position > -1) {
console.log((position/1000) + " sec");
}
},
// 发生错误后调用的回调函数
function(e) {
console.log("Error getting pos=" + e);
}
);
}, 1000);

复制代码

完整的范例：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Media Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
}
// 音频播放器
var my_media = null;
var mediaTimer = null;
// 播放音频
function playAudio(src) {
// 从目标文件创建Media对象
my_media = new Media(src, onSuccess, onError);
// 播放音频
my_media.play();
// 每秒更新一次媒体播放到的位置
if (mediaTimer == null) {
mediaTimer = setInterval(function() {
// 获取媒体播放到的位置
my_media.getCurrentPosition(
//获取成功后调用的回调函数
function(position) {
if (position > -1) {
setAudioPosition((position/1000) + " sec");
}
},
// 发生错误后调用的回调函数
function(e) {
console.log("Error getting pos=" + e);
setAudioPosition("Error: " + e);
}
);
}, 1000);
}
}
// 暂停音频播放
function pauseAudio() {
if (my_media) {
my_media.pause();
}
}
// 停止音频播放
function stopAudio() {
if (my_media) {
my_media.stop();
}
clearInterval(mediaTimer);
mediaTimer = null;
}
// 创建Media对象成功后调用的回调函数
function onSuccess() {
console.log("playAudio():Audio Success");
}
// 创建Media对象出错后调用的回调函数
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// 设置音频播放位置
function setAudioPosition(position) {
document.getElementById('audio_position').innerHTML = position;
}
</script>
</head>
<body>
<a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
<a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
<a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
<p id="audio_position"></p>
</body>
</html>

复制代码

media.getDuration
返回音频文件的时间长度。

media.getDuration();

复制代码

说明：media.getDuration是一个同步函数，如果音频时长已知的话则返回以秒为单位的音频文件时长，如果时长不可知的话则返回-1。

支持的平台：

Android
iOS

简单的范例：

// 音频播放器
var my_media = new Media(src, onSuccess, onError);
// 获得时间长度
var counter = 0;
var timerDur = setInterval(function() {
countercounter = counter + 100;
if (counter > 2000) {
clearInterval(timerDur);
}
var dur = my_media.getDuration();
if (dur > 0) {
clearInterval(timerDur);
document.getElementById('audio_duration').innerHTML = (dur/1000) + " sec";
}
}, 100);

复制代码

完整的范例：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Media Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
}
// 音频播放器
var my_media = null;
var mediaTimer = null;
// 播放音频
function playAudio(src) {
// 从目标文件创建Media对象
my_media = new Media(src, onSuccess, onError);
// 播放音频
my_media.play();
// 每秒更新一次媒体播放到的位置
if (mediaTimer == null) {
mediaTimer = setInterval(function() {
// 获取媒体播放到的位置
my_media.getCurrentPosition(
// 获取成功后调用的回调函数
function(position) {
if (position > -1) {
setAudioPosition((position/1000) + " sec");
}
},
// 发生错误后调用的回调函数
function(e) {
console.log("Error getting pos=" + e);
setAudioPosition("Error: " + e);
}
);
}, 1000);
}
}
// 暂停音频播放
function pauseAudio() {
if (my_media) {
my_media.pause();
}
}
// 停止音频播放
function stopAudio() {
if (my_media) {
my_media.stop();
}
clearInterval(mediaTimer);
mediaTimer = null;
}
// 创建Media对象成功后调用的回调函数
function onSuccess() {
console.log("playAudio():Audio Success");
}
// 创建Media对象出错后调用的回调函数
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// 设置音频播放位置
function setAudioPosition(position) {
document.getElementById('audio_position').innerHTML = position;
}
</script>
</head>
<body>
<a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
<a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
<a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
<p id="audio_position"></p>
</body>
</html>

复制代码

media.play开始或恢复播放一个音频文件。

media.play();

复制代码

说明：media.play是一个用于开始或恢复播放音频文件的同步函数。

支持的平台：

Android
iOS

简单的范例：

// 播放音频文件
function playAudio(url) {
// 播放url指向的音频文件
var my_media = new Media(url,
// 播放成功后调用的回调函数
function() {
console.log("playAudio():Audio Success");
},
// 播放出错后调用的回调函数
function(err) {
console.log("playAudio():Audio Error: "+err);
});
// 播放音频文件
my_media.play();
}

复制代码

完整的范例：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Media Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
}
// 音频播放器
var my_media = null;
var mediaTimer = null;
// 播放音频文件
function playAudio(src) {
// 从目标文件创建Media对象
my_media = new Media(src, onSuccess, onError);
// 播放音频
my_media.play();
// 每秒更新一次媒体播放到的位置
if (mediaTimer == null) {
mediaTimer = setInterval(function() {
// 获取媒体播放到的位置
my_media.getCurrentPosition(
// 获取成功后调用的回调函数
function(position) {
if (position > -1) {
setAudioPosition((position/1000) + " sec");
}
},
// 发生错误后调用的回调函数
function(e) {
console.log("Error getting pos=" + e);
setAudioPosition("Error: " + e);
}
);
}, 1000);
}
}
// 暂停音频播放
function pauseAudio() {
if (my_media) {
my_media.pause();
}
}
// 停止音频播放
function stopAudio() {
if (my_media) {
my_media.stop();
}
clearInterval(mediaTimer);
mediaTimer = null;
}
// 创建Media对象成功后调用的回调函数
function onSuccess() {
console.log("playAudio():Audio Success");
}
// 创建Media对象出错后调用的回调函数
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// 设置音频播放位置
function setAudioPosition(position) {
document.getElementById('audio_position').innerHTML = position;
}
</script>
</head>
<body>
<a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
<a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
<a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
<p id="audio_position"></p>
</body>
</html>

复制代码

media.pause
暂停播放一个音频文件。

media.pause();

复制代码

说明：media.pause是一个用于暂停播放音频文件的同步函数。

支持的平台：

Android
iOS

简单的范例：

// 播放音频
function playAudio(url) {
// 播放url指向的音频文件
var my_media = new Media(url,
// 获取成功后调用的回调函数
function() {
console.log("playAudio():Audio Success");
},
// 发生错误后调用的回调函数
function(err) {
console.log("playAudio():Audio Error: "+err);
}
)
// 播放音频
my_media.play();
// 暂停10秒钟
setTimeout(function() {
media.pause();
}, 10000);
}

复制代码

完整的范例：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Media Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
}
// 音频播放器
var my_media = null;
var mediaTimer = null;
// 播放音频
function playAudio(src) {
// 从目标播放文件创建Media对象
my_media = new Media(src, onSuccess, onError);
// 播放音频
my_media.play();
// 每秒更新一次媒体播放到的位置
if (mediaTimer == null) {
mediaTimer = setInterval(function() {
// 获取媒体播放到的位置
my_media.getCurrentPosition(
// 获取成功后调用的回调函数
function(position) {
if (position > -1) {
setAudioPosition((position/1000) + " sec");
}
},
// 发生错误后调用的回调函数
function(e) {
console.log("Error getting pos=" + e);
setAudioPosition("Error: " + e);
}
);
}, 1000);
}
}
// 暂停音频播放
function pauseAudio() {
if (my_media) {
my_media.pause();
}
}
// 停止音频播放
function stopAudio() {
if (my_media) {
my_media.stop();
}
clearInterval(mediaTimer);
mediaTimer = null;
}
// 创建Media对象成功后调用的回调函数
function onSuccess() {
console.log("playAudio():Audio Success");
}
// 创建Media对象出错后调用的回调函数
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// 设置音频播放位置
function setAudioPosition(position) {
document.getElementById('audio_position').innerHTML = position;
}
</script>
</head>
<body>
<a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
<a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
<a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
<p id="audio_position"></p>
</body>
</html>

复制代码

media.release
释放底层操作系统音频资源。

media.release();

复制代码

说明：
media.release是一个用于释放系统音频资源的同步函数。该函数对于Android系统尤为重要，因为Android系统的OpenCore（多媒体核心）的实例是有限的。开发者需要在他们不再需要相应Media资源时调用“release”函数释放它。

支持的平台：

Android
iOS

简单的范例：

// 音频播放器
var my_media = new Media(src, onSuccess, onError);
my_media.play();
my_media.stop();
my_media.release();

复制代码

完整的范例：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Media Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
}
// 音频播放器
var my_media = null;
var mediaTimer = null;
// 播放音频
function playAudio(src) {
// 从目标播放文件创建Media对象
my_media = new Media(src, onSuccess, onError);
// 播放音频
my_media.play();
// 每秒更新一次媒体播放到的位置
if (mediaTimer == null) {
mediaTimer = setInterval(function() {
// 获取媒体播放到的位置
my_media.getCurrentPosition(
// 获取成功后调用的回调函数
function(position) {
if (position > -1) {
setAudioPosition((position/1000) + " sec");
}
},
// 发生错误后调用的回调函数
function(e) {
console.log("Error getting pos=" + e);
setAudioPosition("Error: " + e);
}
);
}, 1000);
}
}
// 暂停音频播放
function pauseAudio() {
if (my_media) {
my_media.pause();
}
}
// 停止音频播放
function stopAudio() {
if (my_media) {
my_media.stop();
}
clearInterval(mediaTimer);
mediaTimer = null;
}
// 创建Media对象成功后调用的回调函数
function onSuccess() {
console.log("playAudio():Audio Success");
}
// 创建Media对象出错后调用的回调函数
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
}
// 设置音频播放位置
function setAudioPosition(position) {
document.getElementById('audio_position').innerHTML = position;
}
</script>
</head>
<body>
<a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
<a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
<a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
<p id="audio_position"></p>
</body>
</html>

复制代码

media.startRecord 开始录制一个音频文件。

media.startRecord();

复制代码

说明：media.startRecord是用于开始录制一个音频文件的同步函数。

支持的平台：

Android
iOS

简单的范例：

// 录制音频
function recordAudio() {
var src = "myrecording.mp3";
var mediaRec = new Media(src,
// 新建Media对象成功后调用的回调函数
function() {
console.log("recordAudio():Audio Success");
}, <

posted @ 2014-03-20 12:13 huidaoli 阅读(246) 评论(0) 编辑收藏举报

刷新页面返回顶部

huidaoli

小李飞刀的博客

PhoneGap API帮助文档翻译—Media（媒体）

公告