AudioLoader.html 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107
  1. <!DOCTYPE html>
  2. <html lang="ar">
  3. <head>
  4. <meta charset="utf-8" />
  5. <base href="../../../" />
  6. <script src="page.js"></script>
  7. <link type="text/css" rel="stylesheet" href="page.css" />
  8. </head>
  9. <body class="rtl">
  10. [page:Loader] &rarr;
  11. <h1>[name]</h1>
  12. <p class="desc">
  13. فئة لتحميل
  14. [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer AudioBuffer].
  15. يستخدم هذا [page:FileLoader] داخليًا لتحميل
  16. الملفات.
  17. </p>
  18. <h2>مثال للكود</h2>
  19. <code>
  20. // instantiate a listener
  21. const audioListener = new THREE.AudioListener();
  22. // add the listener to the camera
  23. camera.add( audioListener );
  24. // instantiate audio object
  25. const oceanAmbientSound = new THREE.Audio( audioListener );
  26. // add the audio object to the scene
  27. scene.add( oceanAmbientSound );
  28. // instantiate a loader
  29. const loader = new THREE.AudioLoader();
  30. // load a resource
  31. loader.load(
  32. // resource URL
  33. 'audio/ambient_ocean.ogg',
  34. // onLoad callback
  35. function ( audioBuffer ) {
  36. // set the audio object buffer to the loaded object
  37. oceanAmbientSound.setBuffer( audioBuffer );
  38. // play the audio
  39. oceanAmbientSound.play();
  40. },
  41. // onProgress callback
  42. function ( xhr ) {
  43. console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
  44. },
  45. // onError callback
  46. function ( err ) {
  47. console.log( 'An error happened' );
  48. }
  49. );
  50. </code>
  51. <h2>المنشئ (Constructor)</h2>
  52. <h3>[name]( [param:LoadingManager manager] )</h3>
  53. <p>
  54. [page:LoadingManager manager] — [page:LoadingManager loadingManager]
  55. للمحمل الذي سيتم استخدامه. الافتراضي هو [page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
  56. ينشئ جديدًا [name].
  57. </p>
  58. <h2>الخصائص (Properties)</h2>
  59. <p>انظر الفئة الأساسية [page:Loader] للخصائص المشتركة.</p>
  60. <h2>الطرق (Methods)</h2>
  61. <p>انظر الفئة الأساسية [page:Loader] للطرق المشتركة.</p>
  62. <h3>
  63. [method:undefined load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )
  64. </h3>
  65. <p>
  66. [page:String url] — المسار أو عنوان URL للملف. يمكن أن يكون هذا أيضًا
  67. [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
  68. [page:Function onLoad] — سيتم استدعاؤه عند اكتمال التحميل. الحجة
  69. ستكون الاستجابة المحملة للنص.<br />
  70. [page:Function onProgress] (اختياري) — سيتم استدعاؤه أثناء التقدم في التحميل
  71. يتقدم. الحجة ستكون نسخة ProgressEvent، والتي
  72. يحتوي على .[page:Boolean lengthComputable]، .[page:Integer total] و
  73. .[page:Integer loaded]. إذا لم يضبط الخادم رأس Content-Length
  74. .[page:Integer total] سيكون 0.<br />
  75. [page:Function onError] (اختياري) — سيتم استدعاؤه إذا حدث خطأ في التحميل.<br />
  76. </p>
  77. <p>
  78. ابدأ التحميل من url وأرسل المحمَّل [page:String AudioBuffer] إلى
  79. onLoad.
  80. </p>
  81. <h2>المصدر (Source)</h2>
  82. <p>
  83. [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
  84. </p>
  85. </body>
  86. </html>