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

最新推荐文章于 2021-05-31 12:05:22 发布
最新推荐文章于 2021-05-31 12:05:22 发布
阅读量331 收藏
点赞数
分类专栏： android phonegap
  Media对象提供录制和回放设备上的音频文件的能力。
[html] view plain copy
  1. 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 
 
返回返回一个音频文件的当前的位置。
[html] view plain copy
  1. media.getCurrentPosition(mediaSuccess, [mediaError]);  
参数：
  • mediaSuccess：成功的回调函数，返回当前的位置。
  • mediaError：（可选项）如果发生错误时调用的回调函数。
说明：
media.getCurrentPosition是一个异步函数，用户返回一个Media对象所指向的音频文件的当前位置，同时会对Media对象的_position参数进行更新。
支持的平台：
  • Android
  • iOS
简单的范例：
[html] view plain copy
  1. // 音频播放器  
  2. var my_media = new Media(src, onSuccess, onError);  
  3.   
  4. // 每秒更新一次媒体播放到的位置  
  5. var mediaTimer = setInterval(function() {  
  6.     // 获得媒体位置  
  7.     my_media.getCurrentPosition(  
  8.         // 获得成功后调用的回调函数  
  9.         function(position) {  
  10.             if (position > -1) {  
  11.                 console.log((position/1000) + " sec");  
  12.             }  
  13.         },  
  14.         // 发生错误后调用的回调函数  
  15.         function(e) {  
  16.             console.log("Error getting pos=" + e);  
  17.         }  
  18.     );  
  19. }, 1000);  
完整的范例：
[html] view plain copy
  1. <!DOCTYPE html>  
        <html>  
        <head>      
        <title>Media Example</title>  
          
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script> 
  2. <script type="text/javascript" charset="utf-8">  
  3.   
  4. // 等待加载PhoneGap  
  5. document.addEventListener("deviceready", onDeviceReady, false);   
  6.   
  7. // PhoneGap加载完毕  
  8. function onDeviceReady() {  
  9.     playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");  
  10. }  
  11.   
  12. // 音频播放器  
  13. var my_media = null;  
  14. var mediaTimer = null;  
  15.   
  16. // 播放音频  
  17. function playAudio(src) {  
  18.     // 从目标文件创建Media对象  
  19.     my_media = new Media(src, onSuccess, onError);  
  20.   
  21.     // 播放音频  
  22.     my_media.play();  
  23.   
  24.     // 每秒更新一次媒体播放到的位置  
  25.     if (mediaTimer == null) {  
  26.         mediaTimer = setInterval(function() {  
  27.             // 获取媒体播放到的位置  
  28.             my_media.getCurrentPosition(          
  29.           
  30.                 //获取成功后调用的回调函数  
  31.                 function(position) {  
  32.                     if (position > -1) {  
  33.                         setAudioPosition((position/1000) + " sec");  
  34.                     }  
  35.                 },  
  36.                 // 发生错误后调用的回调函数  
  37.                 function(e) {  
  38.                     console.log("Error getting pos=" + e);  
  39.                     setAudioPosition("Error: " + e);  
  40.                 }  
  41.             );  
  42.         }, 1000);  
  43.     }  
  44. }  
  45.   
  46. // 暂停音频播放  
  47. function pauseAudio() {  
  48.     if (my_media) {  
  49.         my_media.pause();  
  50.     }  
  51. }  
  52.   
  53. // 停止音频播放  
  54. function stopAudio() {  
  55.     if (my_media) {  
  56.         my_media.stop();  
  57.     }  
  58.     clearInterval(mediaTimer);  
  59.     mediaTimer = null;  
  60. }  
  61.   
  62. // 创建Media对象成功后调用的回调函数  
  63. function onSuccess() {  
  64.     console.log("playAudio():Audio Success");  
  65. }  
  66.   
  67. // 创建Media对象出错后调用的回调函数  
  68. function onError(error) {  
  69.     alert('code: '    + error.code    + '\n' +   
  70.         'message: ' + error.message + '\n');  
  71. }  
  72.   
  73. // 设置音频播放位置  
  74. function setAudioPosition(position) {  
  75.     document.getElementById('audio_position').innerHTML = position;  
  76. }  
  77.   
  78. </script>  
  79. </head>  
  80. <body>  
  81.     <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>  
  82.     <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>  
  83.     <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>  
  84.     <p id="audio_position"></p>  
  85. </body>  
  86. </html>  
media.getDuration 
 
返回音频文件的时间长度。
[html] view plain copy
  1. media.getDuration();  
说明：
media.getDuration是一个同步函数，如果音频时长已知的话则返回以秒为单位的音频文件时长，如果时长不可知的话则返回-1。
支持的平台：
  • Android
  • iOS
简单的范例：
[html] view plain copy
  1. // 音频播放器  
  2. var my_media = new Media(src, onSuccess, onError);  
  3.   
  4. // 获得时间长度  
  5. var counter = 0;  
  6. var timerDur = setInterval(function() {  
  7.     counter = counter + 100;  
  8.     if (counter > 2000) {  
  9.         clearInterval(timerDur);  
  10.     }  
  11.     var dur = my_media.getDuration();  
  12.     if (dur > 0) {  
  13.         clearInterval(timerDur);  
  14.         document.getElementById('audio_duration').innerHTML = (dur/1000) + " sec";  
  15.     }  
  16. }, 100);  
完整的范例：
[html] view plain copy
  1. <!DOCTYPE html>  
        <html>  
        <head>      
        <title>Media Example</title>  
          
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script> 
  2.   
  3. <script type="text/javascript" charset="utf-8">  
  4.   
  5.     // 等待加载PhoneGap  
  6.     document.addEventListener("deviceready", onDeviceReady, false);   
  7.       
  8.     // PhoneGap加载完毕  
  9.     function onDeviceReady() {  
  10.         playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");  
  11.     }  
  12.       
  13.     // 音频播放器  
  14.     var my_media = null;  
  15.     var mediaTimer = null;  
  16.       
  17.     // 播放音频  
  18.     function playAudio(src) {  
  19.         // 从目标文件创建Media对象  
  20.         my_media = new Media(src, onSuccess, onError);  
  21.       
  22.         // 播放音频  
  23.         my_media.play();  
  24.       
  25.         // 每秒更新一次媒体播放到的位置  
  26.         if (mediaTimer == null) {  
  27.             mediaTimer = setInterval(function() {  
  28.                 // 获取媒体播放到的位置  
  29.                 my_media.getCurrentPosition(  
  30.                     // 获取成功后调用的回调函数  
  31.                     function(position) {  
  32.                         if (position > -1) {  
  33.                             setAudioPosition((position/1000) + " sec");  
  34.                         }  
  35.                     },  
  36.                     // 发生错误后调用的回调函数  
  37.                     function(e) {  
  38.                         console.log("Error getting pos=" + e);  
  39.                         setAudioPosition("Error: " + e);  
  40.                     }  
  41.                 );  
  42.             }, 1000);  
  43.         }  
  44.     }  
  45.       
  46.     // 暂停音频播放  
  47.     function pauseAudio() {  
  48.         if (my_media) {  
  49.             my_media.pause();  
  50.         }  
  51.     }  
  52.       
  53.     // 停止音频播放  
  54.     function stopAudio() {  
  55.         if (my_media) {  
  56.             my_media.stop();  
  57.         }  
  58.         clearInterval(mediaTimer);  
  59.         mediaTimer = null;  
  60.     }  
  61.       
  62.     // 创建Media对象成功后调用的回调函数  
  63.     function onSuccess() {  
  64.         console.log("playAudio():Audio Success");  
  65.     }  
  66.       
  67.     // 创建Media对象出错后调用的回调函数  
  68.     function onError(error) {  
  69.         alert('code: '    + error.code    + '\n' +   
  70.             'message: ' + error.message + '\n');  
  71.     }  
  72.       
  73.     // 设置音频播放位置  
  74.     function setAudioPosition(position) {  
  75.         document.getElementById('audio_position').innerHTML = position;  
  76.     }  
  77.   
  78. </script>  
  79. </head>  
  80. <body>  
  81.     <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>  
  82.     <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>  
  83.     <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>  
  84.     <p id="audio_position"></p>  
  85. </body>  
  86. </html>  
media.play 
 
开始或恢复播放一个音频文件。
[html] view plain copy
  1. media.play();  
说明：
media.play是一个用于开始或恢复播放音频文件的同步函数。
支持的平台：
  • Android
  • iOS
简单的范例：
[html] view plain copy
  1. // 播放音频文件  
  2. function playAudio(url) {  
  3.     // 播放url指向的音频文件  
  4.     var my_media = new Media(url,  
  5.     // 播放成功后调用的回调函数  
  6.     function() {  
  7.         console.log("playAudio():Audio Success");  
  8.     },  
  9.     // 播放出错后调用的回调函数  
  10.     function(err) {  
  11.         console.log("playAudio():Audio Error: "+err);  
  12.     });  
  13.   
  14. // 播放音频文件  
  15. my_media.play();  
  16. }  
完整的范例：
[html] view plain copy
  1. <!DOCTYPE html>  
        <html>  
        <head>      
        <title>Media Example</title>  
          
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script> 
  3. <script type="text/javascript" charset="utf-8">  
  4.   
  5.     // 等待加载PhoneGap  
  6.     document.addEventListener("deviceready", onDeviceReady, false);   
  7.       
  8.     // PhoneGap加载完毕  
  9.     function onDeviceReady() {  
  10.         playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");  
  11.     }  
  12.       
  13.     // 音频播放器  
  14.     var my_media = null;  
  15.     var mediaTimer = null;  
  16.       
  17.     // 播放音频文件  
  18.     function playAudio(src) {  
  19.         // 从目标文件创建Media对象  
  20.         my_media = new Media(src, onSuccess, onError);  
  21.       
  22.         // 播放音频  
  23.         my_media.play();  
  24.       
  25.         // 每秒更新一次媒体播放到的位置  
  26.         if (mediaTimer == null) {  
  27.             mediaTimer = setInterval(function() {  
  28.                 // 获取媒体播放到的位置  
  29.                 my_media.getCurrentPosition(  
  30.                     // 获取成功后调用的回调函数  
  31.                     function(position) {  
  32.                         if (position > -1) {  
  33.                             setAudioPosition((position/1000) + " sec");  
  34.                         }  
  35.                     },  
  36.                     // 发生错误后调用的回调函数  
  37.                     function(e) {  
  38.                         console.log("Error getting pos=" + e);  
  39.                         setAudioPosition("Error: " + e);  
  40.                     }  
  41.                 );  
  42.             }, 1000);  
  43.         }  
  44.     }  
  45.       
  46.     // 暂停音频播放   
  47.     function pauseAudio() {  
  48.         if (my_media) {  
  49.             my_media.pause();  
  50.         }  
  51.     }  
  52.       
  53.     // 停止音频播放         
  54.     function stopAudio() {  
  55.         if (my_media) {  
  56.             my_media.stop();  
  57.         }  
  58.         clearInterval(mediaTimer);  
  59.         mediaTimer = null;  
  60.     }  
  61.       
  62.     // 创建Media对象成功后调用的回调函数  
  63.     function onSuccess() {  
  64.         console.log("playAudio():Audio Success");  
  65.     }  
  66.       
  67.     // 创建Media对象出错后调用的回调函数  
  68.     function onError(error) {  
  69.         alert('code: '    + error.code    + '\n' +   
  70.               'message: ' + error.message + '\n');  
  71.     }  
  72.       
  73.     // 设置音频播放位置  
  74.     function setAudioPosition(position) {  
  75.         document.getElementById('audio_position').innerHTML = position;  
  76.     }  
  77.   
  78. </script>  
  79. </head>  
  80. <body>  
  81.     <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>  
  82.     <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>  
  83.     <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>  
  84.     <p id="audio_position"></p>  
  85. </body>  
  86. </html>  
media.pause 
 
暂停播放一个音频文件。
[html] view plain copy
  1. media.pause();  
说明：
media.pause是一个用于暂停播放音频文件的同步函数。
支持的平台：
  • Android
  • iOS
简单的范例：
[html] view plain copy
  1. // 播放音频  
  2. function playAudio(url) {  
  3.     // 播放url指向的音频文件  
  4.     var my_media = new Media(url,  
  5.         // 获取成功后调用的回调函数  
  6.         function() {  
  7.             console.log("playAudio():Audio Success");  
  8.         },  
  9.         // 发生错误后调用的回调函数  
  10.         function(err) {  
  11.             console.log("playAudio():Audio Error: "+err);  
  12.         }  
  13.     )  
  14.   
  15.     // 播放音频  
  16.     my_media.play();  
  17.   
  18.     // 暂停10秒钟  
  19.     setTimeout(function() {  
  20.         media.pause();  
  21.     }, 10000);          
  22. }  
完整的范例：
[html] view plain copy
  1. <!DOCTYPE html>  
        <html>  
        <head>      
        <title>Media Example</title>  
          
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script> 
  2.  
  3. <script type="text/javascript" charset="utf-8">  
  4.   
  5.     // 等待加载PhoneGap  
  6.     document.addEventListener("deviceready", onDeviceReady, false);   
  7.       
  8.     // PhoneGap加载完毕  
  9.     function onDeviceReady() {  
  10.         playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");  
  11.     }  
  12.       
  13.     // 音频播放器  
  14.     var my_media = null;  
  15.     var mediaTimer = null;  
  16.       
  17.     // 播放音频  
  18.     function playAudio(src) {  
  19.         // 从目标播放文件创建Media对象  
  20.         my_media = new Media(src, onSuccess, onError);  
  21.         // 播放音频  
  22.         my_media.play();  
  23.       
  24.         // 每秒更新一次媒体播放到的位置  
  25.         if (mediaTimer == null) {  
  26.             mediaTimer = setInterval(function() {  
  27.                 // 获取媒体播放到的位置  
  28.                 my_media.getCurrentPosition(  
  29.                     // 获取成功后调用的回调函数  
  30.                     function(position) {  
  31.                         if (position > -1) {  
  32.                             setAudioPosition((position/1000) + " sec");  
  33.                         }  
  34.                     },  
  35.                     // 发生错误后调用的回调函数  
  36.                     function(e) {  
  37.                         console.log("Error getting pos=" + e);  
  38.                         setAudioPosition("Error: " + e);  
  39.                     }  
  40.                 );  
  41.             }, 1000);  
  42.         }  
  43.     }  
  44.       
  45.     // 暂停音频播放  
  46.     function pauseAudio() {  
  47.         if (my_media) {  
  48.             my_media.pause();  
  49.         }  
  50.     }  
  51.       
  52.     // 停止音频播放  
  53.     function stopAudio() {  
  54.         if (my_media) {  
  55.             my_media.stop();  
  56.         }  
  57.         clearInterval(mediaTimer);  
  58.         mediaTimer = null;  
  59.     }  
  60.       
  61.     // 创建Media对象成功后调用的回调函数  
  62.     function onSuccess() {  
  63.         console.log("playAudio():Audio Success");  
  64.     }  
  65.       
  66.     // 创建Media对象出错后调用的回调函数  
  67.     function onError(error) {  
  68.         alert('code: '    + error.code    + '\n' +   
  69.             'message: ' + error.message + '\n');  
  70.     }  
  71.       
  72.     // 设置音频播放位置   
  73.     function setAudioPosition(position) {  
  74.         document.getElementById('audio_position').innerHTML = position;  
  75.     }  
  76.   
  77. </script>  
  78. </head>  
  79. <body>  
  80.     <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>  
  81.     <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>  
  82.     <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>  
  83.     <p id="audio_position"></p>  
  84. </body>  
  85. </html>  
media.release 
 
释放底层操作系统音频资源。
[html] view plain copy
  1. media.release();  
说明：
media.release是一个用于释放系统音频资源的同步函数。该函数对于Android系统尤为重要，因为Android系统的OpenCore（多媒体核心）的实例是有限的。开发者需要在他们不再需要相应Media资源时调用“release”函数释放它。
支持的平台：
  • Android
  • iOS
简单的范例：
[html] view plain copy
  1. // 音频播放器  
  2. var my_media = new Media(src, onSuccess, onError);  
  3.   
  4. my_media.play();  
  5. my_media.stop();  
  6. my_media.release();  
完整的范例：
[html] view plain copy
  1. <!DOCTYPE html>  
        <html>  
        <head>      
        <title>Media Example</title>  
          
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script> 
  3. <script type="text/javascript" charset="utf-8">  
  4.   
  5.     // 等待加载PhoneGap  
  6.     document.addEventListener("deviceready", onDeviceReady, false);   
  7.       
  8.     // PhoneGap加载完毕  
  9.     function onDeviceReady() {  
  10.         playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");  
  11.     }  
  12.       
  13.     // 音频播放器  
  14.     var my_media = null;  
  15.     var mediaTimer = null;  
  16.     // 播放音频  
  17.     function playAudio(src) {  
  18.         // 从目标播放文件创建Media对象  
  19.         my_media = new Media(src, onSuccess, onError);  
  20.       
  21.         // 播放音频  
  22.         my_media.play();  
  23.       
  24.         // 每秒更新一次媒体播放到的位置  
  25.         if (mediaTimer == null) {  
  26.             mediaTimer = setInterval(function() {  
  27.                 // 获取媒体播放到的位置  
  28.                 my_media.getCurrentPosition(  
  29.                     // 获取成功后调用的回调函数  
  30.                     function(position) {  
  31.                         if (position > -1) {  
  32.                             setAudioPosition((position/1000) + " sec");  
  33.                         }  
  34.                     },  
  35.                     // 发生错误后调用的回调函数  
  36.                     function(e) {  
  37.                         console.log("Error getting pos=" + e);  
  38.                         setAudioPosition("Error: " + e);  
  39.                     }  
  40.                 );  
  41.             }, 1000);  
  42.         }  
  43.     }  
  44.       
  45.     // 暂停音频播放         
  46.     function pauseAudio() {  
  47.         if (my_media) {  
  48.             my_media.pause();  
  49.         }  
  50.     }  
  51.       
  52.     // 停止音频播放   
  53.     function stopAudio() {  
  54.         if (my_media) {  
  55.             my_media.stop();  
  56.         }  
  57.         clearInterval(mediaTimer);  
  58.         mediaTimer = null;  
  59.     }  
  60.       
  61.     // 创建Media对象成功后调用的回调函数         
  62.     function onSuccess() {  
  63.         console.log("playAudio():Audio Success");  
  64.     }  
  65.       
  66.     // 创建Media对象出错后调用的回调函数         
  67.     function onError(error) {  
  68.         alert('code: '    + error.code    + '\n' +   
  69.             'message: ' + error.message + '\n');  
  70.     }  
  71.       
  72.     // 设置音频播放位置  
  73.     function setAudioPosition(position) {  
  74.         document.getElementById('audio_position').innerHTML = position;  
  75.     }  
  76.   
  77. </script>  
  78. </head>  
  79. <body>  
  80.     <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>  
  81.     <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>  
  82.     <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>  
  83.     <p id="audio_position"></p>  
  84. </body>  
  85. </html>  
media.startRecord 
 
开始录制一个音频文件。
[html] view plain copy
  1. media.startRecord();  
说明：
media.startRecord是用于开始录制一个音频文件的同步函数。
支持的平台：
  • Android
  • iOS
简单的范例：
[html] view plain copy
  1. // 录制音频  
  2. function recordAudio() {  
  3.     var src = "myrecording.mp3";  
  4.     var mediaRec = new Media(src,  
  5.         // 新建Media对象成功后调用的回调函数  
  6.         function() {  
  7.             console.log("recordAudio():Audio Success");  
  8.         },  
  9.   
  10.         // 新建Media对象出错后调用的回调函数  
  11.         function(err) {  
  12.             console.log("recordAudio():Audio Error: "+ err.code);  
  13.         }  
  14.     );  
  15.   
  16.     // 录制音频  
  17.     mediaRec.startRecord();  
  18. }  
完整的范例：
[html] view plain copy
  1. <!DOCTYPE html>  
        <html>  
        <head>      
        <title>Media Example</title>  
          
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script> 
  3. <script type="text/javascript" charset="utf-8">  
  4.   
  5.     // 等待加载PhoneGap  
  6.     document.addEventListener("deviceready", onDeviceReady, false);   
  7.       
  8.     // 录制音频  
  9.     function recordAudio() {  
  10.         var src = "myrecording.mp3";  
  11.         var mediaRec = new Media(src, onSuccess, onError);  
  12.       
  13.         // 开始录制音频  
  14.         mediaRec.startRecord();  
  15.       
  16.         // 10秒钟后停止录制  
  17.         var recTime = 0;  
  18.         var recInterval = setInterval(function() {  
  19.             recTime = recTime + 1;  
  20.             setAudioPosition(recTime + " sec");  
  21.             if (recTime >= 10) {  
  22.                 clearInterval(recInterval);  
  23.                 mediaRec.stopRecord();  
  24.             }  
  25.         }, 1000);  
  26.     }  
  27.       
  28.     // PhoneGap加载完毕   
  29.     function onDeviceReady() {  
  30.         recordAudio();  
  31.     }  
  32.       
  33.     // 创建Media对象成功后调用的回调函数  
  34.     function onSuccess() {  
  35.         console.log("recordAudio():Audio Success");  
  36.     }  
  37.       
  38.     // 创建Media对象出错后调用的回调函数  
  39.     function onError(error) {  
  40.         alert('code: '    + error.code    + '\n' +   
  41.               'message: ' + error.message + '\n');  
  42.     }  
  43.       
  44.     // 设置音频播放位置  
  45.     function setAudioPosition(position) {  
  46.         document.getElementById('audio_position').innerHTML = position;  
  47.     }  
  48.   
  49. </script>  
  50. </head>  
  51. <body>  
  52.     <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>  
  53.     <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>  
  54.     <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>  
  55.     <p id="audio_position"></p>  
  56. </body>  
  57. </html>  
iOS 的特异情况：
  • 用于录制的文件必须已经存在并是.wav类型，可以通过File API来进行文件的创建。
media.stop 
 
停止播放一个音频文件。
[html] view plain copy
  1. media.stop();  
说明：
media.stop函数是一个用于停止播放音频文件的同步函数。
支持的平台：
  • Android
  • iOS
简单的范例：
[html] view plain copy
  1. // 播放音频  
  2. function playAudio(url) {  
  3. // 播放url指向的音频文件  
  4. var my_media = new Media(url,  
  5.     // 新建Media对象成功后调用的回调函数  
  6.     function() {  
  7.         console.log("playAudio():Audio Success");  
  8.     },  
  9.     // 新建Media对象出错后调用的回调函数  
  10.     function(err) {  
  11.         console.log("playAudio():Audio Error: "+err);  
  12.     }  
  13. );  
  14.   
  15. // 播放音频  
  16. my_media.play();  
  17.   
  18. // 10秒钟后暂停播放  
  19. setTimeout(function() {  
  20.     my_media.stop();  
  21.     }, 10000);          
  22. }  
完整的范例：
[html] view plain copy
  1. <!DOCTYPE html>  
        <html>  
        <head>      
        <title>Media Example</title>  
          
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script> 
  3. <script type="text/javascript" charset="utf-8">  
  4.   
  5.     // 等待加载PhoneGap  
  6.     document.addEventListener("deviceready", onDeviceReady, false);   
  7.       
  8.     // PhoneGap加载完毕  
  9.     function onDeviceReady() {  
  10.         playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");  
  11.     }  
  12.       
  13.     // 音频播放器  
  14.     var my_media = null;  
  15.     var mediaTimer = null;  
  16.       
  17.     // 播放音频  
  18.     function playAudio(src) {  
  19.         // 从目标播放文件创建Media对象  
  20.         my_media = new Media(src, onSuccess, onError);  
  21.       
  22.         // 播放音频  
  23.         my_media.play();  
  24.       
  25.         // 每秒更新一次媒体播放到的位置  
  26.         if (mediaTimer == null) {  
  27.             mediaTimer = setInterval(function() {  
  28.                 // 获取媒体播放到的位置  
  29.                 my_media.getCurrentPosition(  
  30.                     // 获取成功后调用的回调函数  
  31.                     function(position) {  
  32.                         if (position > -1) {  
  33.                             setAudioPosition((position/1000) + " sec");  
  34.                         }  
  35.                     },  
  36.                     // 发生错误后调用的回调函数  
  37.                     function(e) {  
  38.                         console.log("Error getting pos=" + e);  
  39.                         setAudioPosition("Error: " + e);  
  40.                     }  
  41.                 );  
  42.             }, 1000);  
  43.         }  
  44.     }  
  45.       
  46.     // 暂停音频播放  
  47.     function pauseAudio() {  
  48.         if (my_media) {  
  49.             my_media.pause();  
  50.         }  
  51.     }  
  52.       
  53.     // 停止音频播放         
  54.     function stopAudio() {  
  55.         if (my_media) {  
  56.             my_media.stop();  
  57.         }  
  58.         clearInterval(mediaTimer);  
  59.         mediaTimer = null;  
  60.     }  
  61.       
  62.     // 创建Media对象成功后调用的回调函数         
  63.     function onSuccess() {  
  64.         console.log("playAudio():Audio Success");  
  65.     }  
  66.       
  67.     // 创建Media对象出错后调用的回调函数  
  68.     function onError(error) {  
  69.         alert('code: '    + error.code    + '\n' +   
  70.               'message: ' + error.message + '\n');  
  71.     }  
  72.       
  73.     // 设置音频播放位置  
  74.     function setAudioPosition(position) {  
  75.         document.getElementById('audio_position').innerHTML = position;  
  76.     }  
  77.   
  78. </script>  
  79. </head>  
  80. <body>  
  81.     <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>  
  82.     <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>  
  83.     <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>  
  84.     <p id="audio_position"></p>  
  85. </body>  
  86. </html>  
media.stopRecord 
 
停止录制一个音频文件。
[html] view plain copy
  1. media.stopRecord();  
说明：
media.stopRecord是用于停止录制一个音频文件的同步函数。
支持的平台：
  • Android
  • iOS
简单的范例：
[html] view plain copy
  1. // 录制音频   
  2. function recordAudio() {   
  3.     var src = "myrecording.mp3";   
  4.     var mediaRec = new Media(src,   
  5.         // 新建Media对象成功后调用的回调函数   
  6.         function() {   
  7.             console.log("recordAudio():Audio Success");   
  8.         },   
  9.   
  10.         // 新建Media对象出错后调用的回调函数   
  11.         function(err) {   
  12.             console.log("recordAudio():Audio Error: "+ err.code);   
  13.         }  
  14.     );   
  15.   
  16.     // 开始录制音频   
  17.     mediaRec.startRecord();   
  18.   
  19.     // 10秒后停止录制  
  20.     setTimeout(function() {   
  21.         mediaRec.stopRecord();   
  22.     }, 10000);   
  23. }  
完整的范例：
[html] view plain copy
  1. <!DOCTYPE html>  
        <html>  
        <head>      
        <title>Media Example</title>  
          
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script> 
  2.   
  3. <script type="text/javascript" charset="utf-8">   
  4.   
  5.     // 等待加载PhoneGap  
  6.     document.addEventListener("deviceready", onDeviceReady, false);    
  7.       
  8.     // 录制音频   
  9.     function recordAudio() {   
  10.         var src = "myrecording.mp3";   
  11.         var mediaRec = new Media(src, onSuccess, onError);   
  12.       
  13.         // 开始录制音频   
  14.         mediaRec.startRecord();   
  15.       
  16.         // 10秒后停止录制  
  17.         var recTime = 0;   
  18.         var recInterval = setInterval(function() {   
  19.             recTime = recTime + 1;   
  20.             setAudioPosition(recTime + " sec");   
  21.             if (recTime >= 10) {   
  22.                 clearInterval(recInterval);   
  23.                 mediaRec.stopRecord();   
  24.             }   
  25.         }, 1000);   
  26.     }   
  27.       
  28.     // PhoneGap加载完毕  
  29.     function onDeviceReady() {   
  30.         recordAudio();   
  31.     }   
  32.       
  33.     // 新建Media对象成功后调用的回调函数   
  34.     function onSuccess() {   
  35.         console.log("recordAudio():Audio Success");   
  36.     }   
  37.       
  38.     // 新建Media对象出错后调用的回调函数  
  39.     function onError(error) {   
  40.         alert('code: '    + error.code    + '\n' +    
  41.               'message: ' + error.message + '\n');   
  42.     }   
  43.       
  44.     // 设置音频播放位置   
  45.     function setAudioPosition(position) {   
  46.         document.getElementById('audio_position').innerHTML = position;   
  47.     }   
  48.   
  49. </script>  
  50. </head>  
  51. <body>  
  52.     <p id="media">Recording audio...</p>  
  53.     <p id="audio_position"></p>  
  54. </body>  
  55. </html>  
MediaError 
 
当发生错误时，一个MediaError对象将传递给mediaError回调函数。
属性：
  • code：一个在下面常量列表中定义的错误代码。
  • message：用于描述错误细节的错误信息。
常量：
  • MediaError.MEDIA_ERR_ABORTED：媒体中断错误
  • MediaError.MEDIA_ERR_NETWORK：网络错误
  • MediaError.MEDIA_ERR_DECODE：编码错误
  • MediaError.MEDIA_ERR_NONE_SUPPORTED：格式不支持
说明：
当发生错误时，一个MediaError对象将通过mediaError回调函数传递给用户。
mediaError
 
一个用户指定的回调函数，当媒体函数出现错误的时候被调用。
[html] view plain copy
  1. function(error) {   
  2.     // 处理错误   
  3. }  
参数：
  • error：设备返回的错误信息。（MediaError类型）

更多信息参考：

PhoneGap中国：www.phonegap.cn

中文讨论组：groups.google.com/group/PhoneGapCN


http://blog.csdn.net/phonegapcn/article/details/6702883

gaoshang1999
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Phonegap API （中文版）
11-26
最新的Phonegap api 中文翻译版。让你快速入门。
PhoneGap API帮助文档翻译—Events（事件）
PhoneGap中国
08-19 5064
“   PhoneGap整个生命周期内触发的事件。 事件类型： backbuttondevicereadymenubuttonpauseresumesearchbuttononlineoffline backbutto
Phonegap API 概览
梦_aling 的专栏
02-19 658
Phonegap API 概览 以下是按字母顺序列出的 API 组件: ● Accelerometer——接入设备的运动传感器 ● Camera——使用设备的摄像头进行拍照 ● Capture——使用设备的媒体捕获应用程序捕获媒体文件 ● Compass——获取设备的朝向 ● Connection——快速检查网络状态(无论是WiFi还是蜂窝网络) ● Conta
PhoneGap,API帮助文档.zip
04-06
这个"PhoneGap API帮助文档.zip"压缩包显然包含了关于如何使用PhoneGap API的详细指南，对于开发者来说是非常宝贵的资源。下面我们将深入探讨PhoneGap API中的关键组件及其功能。 1. **加速度计（Accelerometer）**...
PhoneGap中文API帮助文档
07-29
网上的phonegap中文帮助文档尚少，翻译也不太好，在此收集了一些翻译优秀的文章，并制作成chm的帮助文档，以帮助各位学习,此文档包含了phonegap的主要使用功能，并提供了完整示例
PhoneGap,API帮助文档翻译整理10-Media_(媒体)
04-28
在本篇文档中，我们关注的是 PhoneGap 的 Media API，它提供了对移动设备媒体（如音频）的访问和控制能力。 Media API 提供了对音频文件的操作，包括播放、暂停、停止以及获取当前播放位置等功能。以下是对 Media ...
PhoneGap,API帮助文档翻译整理6-Contacts(通讯录).pdf
09-30
PhoneGap,API帮助文档翻译整理6-Contacts(通讯录).pdf
phonegap api中文手册
06-13
phonegap api 中文手册 pdf文件，本人制作
学习PhoneGap Api
冬眠FF的博客
05-08 564
SplashScreen 打开APP时,会黑屏一段时间, 解决方案:放置一张加载的图片。 config.xml preference name="SplashScreen" value="splash" /> preference name="SplashScreenDelay" value="3000" /> splash 是图片的文件名,3000代表图片
PhoneGap API介绍：Connection
Blue .Sky.
06-25 668
本文将介绍PhoneGap API  ——Connection:快速检查WiFi或蜂窝网络的信息。Connection对象提供对设备的蜂窝及WiFi连接信息的访问。通过navigator.network接口访问该对象。 属性： connection.type 常量： connection.UNKNOWN connection.ETHERNET connection.W
phonegap中文文档_PhoneGap API中文帮助文档——Capture (采集) | 学步园
weixin_36443241的博客
02-08 199
提供对设备音频、图像和视频采集功能的访问。对象：CaptureCaptureAudioOptionsCaptureImageOptionsCaptureVideoOptionsCaptureCBCaptureErrorCBConfigurationDataMediaFileMediaFileData方法：capture.captureAudiocapture.captureImagecapture...
用phonegap实现录音功能并上传
muller_z的博客
05-08 3226
phonegap实现录音功能
html5 vedio 抓取,HTML5 js控制vedio视频和分段播放
weixin_36477469的博客
05-31 484
HTML5 vedio常用的js操作1、选择本地资源播放视频html:js:var myVid=document.getElementById("video1");function setMediaFile() {var file = document.getElementById('file').files[0];if(!file){alert("Please upload file.");re...
小白学phoneGap《构建跨平台APP：phoneGap移动应用实战》连载一（PhoneGap中的API）
bookzhaopin的专栏
10-21 1467
之前本博连载过《构建跨平台APP：jQuery Mobile移动应用实战》一书，深受移动开发入门人员的喜爱。 从现在开始，连载它的孪生姐妹书phoneGap移动应用实战一书，希望曾经是小白的你们，已经变成了大白。
android学习笔记----来看看MediaPlayer释放资源release()的使用
aodubi0638的博客
01-02 1663
当查阅 MediaPlayer 文档时 你会发现这个方法setOnCompletionListener，这里的说明指出该方法允许你注册一个回调。当媒体资源或音频文件到达结束位置时会回调该方法，注意该方法的输入是OnCompletionListener 部分代码如下： public class NumbersActivity extends AppCo...
Source Insight 4.0.zip
最新发布
08-14
Source Insight 4.0.zip
PhoneGap API媒体模块详解：参数、错误处理与实例
PhoneGap API帮助文档整理10 - 媒体(Media)部分提供了对在跨平台移动应用开发中使用Media API进行音频和视频处理的关键信息。Media API允许开发者在iOS和Android平台上集成丰富的多媒体功能，如播放、暂停、停止以及...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值