+ Crée un objet audio non-positionnel ( global ).
+
+ La [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API] est utilisée.
+
+ // create an AudioListener and add it to the camera
+ const listener = new THREE.AudioListener();
+ camera.add( listener );
+
+ // create a global audio source
+ const sound = new THREE.Audio( listener );
+
+ // load a sound and set it as the Audio object's buffer
+ const audioLoader = new THREE.AudioLoader();
+ audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
+ sound.setBuffer( buffer );
+ sound.setLoop( true );
+ sound.setVolume( 0.5 );
+ sound.play();
+ });
+
+
+
+ [example:webaudio_sandbox webaudio / sandbox ]
+ [example:webaudio_visualizer webaudio / visualizer ]
+
+ listener — (requis) instance d'[page:AudioListener AudioListener]. +
+ + +Démarrage automatique de la lecture. La valeur par défaut est `false`.
+ +L'[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] du [page:AudioListener listener] passé au constructeur.
+ +Modifie le ton, mesuré en centaines. +/- 100 est un demi-ton. +/- 1200 est un octave. La valeur par défaut est `0`.
+ +Représente un tableau d'[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioNode AudioNodes]. Peut être utilisé pour appliquer une variété de filtres d'ordres inférieurs pour créer des effets sonores complexes. + Dans la plupart des cas, le tableau contient des instances de [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes]. Les filtres sont appliqués via [page:Audio.setFilter] ou [page:Audio.setFilters].
+ +Un [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] créé + en utilisant [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().
+ +Définit si la lecture peut-être contrôlée en utilisant les méthodes [page:Audio.play play](), + [page:Audio.pause pause]() etc. La valeur par défaut est `true`.
+ +Indique si l'audio est en cours de lecture.
+ +Une reference à l'objet listener de cet audio.
+ +Vitesse de lecture. La valeur par défaut est `1`.
+ +Un décalage temporel après lequel la lecture doit commencer. Équivalent au paramètre `offset` de [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). La valeur par défaut est `0`.
+ +Écrase la durée de l'audio. Équivalent au paramètre `duration` de [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). La valeur par défaut est `undefined` afin de jour le buffer entier.
+ +Un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode AudioBufferSourceNode] créé + en utilisant [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createBufferSource AudioContext.createBufferSource]().
+ +Type de source audio. La valeur par défaut est 'empty'.
+ +String indiquant le type, contenant 'Audio'.
+ + ++ Connecte à la [page:Audio.source] audio. Ceci est utilisé en interne à l'initialisation et lors + de l'ajout/retrait de filtres. +
+ ++ Déconnecte de la [page:Audio.source]. Ceci est utilisé en interne lors + de l'ajout/retrait de filtres. +
+ ++ Renvoie le detuning de l'oscillation en centaines. +
+ ++ Renvoie le premier élément du tableau [page:Audio.filters filters]. +
+ ++ Renvoie le tableau [page:Audio.filters filters]. +
+ ++ Renvoie la valeur de [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] + (Indique si la lecture doit boucler). +
+ ++ Renvoie le [page:Audio.gain gainNode]. +
+ ++ Renvoie la valeur de [page:Audio.playbackRate playbackRate]. +
+ ++ Renvoie le volume actuel. +
+ ++ Si [page:Audio.hasPlaybackControl hasPlaybackControl] est à true, la lecture se lance. +
+ ++ Si [page:Audio.hasPlaybackControl hasPlaybackControl] est à true, la lecture se met en pause. +
+ ++ Appelée automatiquement quand la lecture est terminée. +
+ +
+ Met la [page:Audio.source source] à audioBuffer, et met le [page:Audio.sourceType sourceType] à 'buffer'.
+ Si [page:Audio.autoplay autoplay] est activé, la méthode démarrera également la lecture.
+
+ Définit le detuning de l'oscillation en centaines. +
+ ++ Applique un noeud à filtre unique à l'audio. +
+ +
+ value - tableau de filtres.
+ Applique un tableau de noeuds de filtres à l'audio.
+
+ Met [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] à `value` + (Indique si la lecture doit boucler). +
+ ++ Met [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopStart source.loopStart] à `value`. +
+ ++ Met [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopEnd source.loopEnd] à `value`. +
+ +
+ Définit le type d'objet passé en paramètre [link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement HTMLMediaElement] comme source de l'audio.
+ Met également [page:Audio.hasPlaybackControl hasPlaybackControl] à false.
+
+ Définit le type d'objet passé en paramètre [link:https://developer.mozilla.org/en-US/docs/Web/API/MediaStream MediaStream] comme source de l'audio.
+ Met également [page:Audio.hasPlaybackControl hasPlaybackControl] à false.
+
+ Met la [page:Audio.source source] à audioBuffer, et met le [page:Audio.sourceType sourceType] à 'audioNode'.
+ Met également [page:Audio.hasPlaybackControl hasPlaybackControl] à false.
+
+
+ Si [page:Audio.hasPlaybackControl hasPlaybackControl] est activé, mets le [page:Audio.playbackRate playbackRate] à `value`. +
+ ++ Modifie le volume. +
+ ++ Si [page:Audio.hasPlaybackControl hasPlaybackControl] est activé, la lecture est stoppée. +
+ ++ [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js] +
+ + diff --git a/docs/api/fr/audio/AudioAnalyser.html b/docs/api/fr/audio/AudioAnalyser.html new file mode 100644 index 00000000000000..1ff06e15e62238 --- /dev/null +++ b/docs/api/fr/audio/AudioAnalyser.html @@ -0,0 +1,100 @@ + + + + +
+ Crée un objet AudioAnalyser, qui utilise un [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode]
+ afin d'analyser les données audio.
+
+ La [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API] est utilisée.
+
+
+ // create an AudioListener and add it to the camera
+ const listener = new THREE.AudioListener();
+ camera.add( listener );
+
+ // create an Audio source
+ const sound = new THREE.Audio( listener );
+
+ // load a sound and set it as the Audio object's buffer
+ const audioLoader = new THREE.AudioLoader();
+ audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
+ sound.setBuffer( buffer );
+ sound.setLoop(true);
+ sound.setVolume(0.5);
+ sound.play();
+ });
+
+ // create an AudioAnalyser, passing in the sound and desired fftSize
+ const analyser = new THREE.AudioAnalyser( sound, 32 );
+
+ // get the average frequency of the sound
+ const data = analyser.getAverageFrequency();
+
+
+
+ [example:webaudio_sandbox webaudio / sandbox ]
+ [example:webaudio_visualizer webaudio / visualizer ]
+
+ Crée un nouvel [page:AudioAnalyser AudioAnalyser]. +
+ + +Un [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode AnalyserNode] utilisé pour analyser l'audio.
+ ++ Une puissance de deux non-nulle inférieure ou égale à 2048, représentant la taille de la FFT (Fast Fourier Transform - Transformation de Fourier Rapide) à utiliser pour déterminer le domaine de fréquence. + Consulter [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/fftSize cette page] pour obtenir plus de détails. +
+ ++ Un Uint8Array avec une taille determinée par [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/frequencyBinCount analyser.frequencyBinCount] + utilisé pour stocker les données d'analyse. +
+ + ++ Utilise la méthode [link:https://developer.mozilla.org/en-US/docs/Web/API/AnalyserNode/getByteFrequencyData getByteFrequencyData] de l'API Web Audio. + Voir cette page. +
+ ++ Recupère la moyenne des fréquences retournées par la méthode [page:AudioAnalyser.getFrequencyData getFrequencyData]. +
+ ++ [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js] +
+ + diff --git a/docs/api/fr/audio/AudioContext.html b/docs/api/fr/audio/AudioContext.html new file mode 100644 index 00000000000000..c136d204277618 --- /dev/null +++ b/docs/api/fr/audio/AudioContext.html @@ -0,0 +1,43 @@ + + + + +
+ Contient des méthodes afin de configurer un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext].
+
+ Utilisé en interne par les classes [page:AudioListener AudioListener] et [page:AudioLoader AudioLoader] classes.
+
+ La [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API] est utilisée.
+
+ Renvoie la valeur de la variable `context` dans la portée extérieure, si elle est définie, + sinon lui assigne un nouvel [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext]. +
+ ++ Met la variable `context` dans la portée extérieure à `value`. +
+ + ++ [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js] +
+ + diff --git a/docs/api/fr/audio/AudioListener.html b/docs/api/fr/audio/AudioListener.html new file mode 100644 index 00000000000000..e4d8526a0a77cc --- /dev/null +++ b/docs/api/fr/audio/AudioListener.html @@ -0,0 +1,112 @@ + + + + +
+ Le [name] représente un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioListener listener] virtuel de tous les effets audio positionnels et non-positionnels dans la scène.
+ Une application three.js crée généralement une instance unique de [name]. C'est un paramètre de constructeur obligatoire pour les entités audio comme [page:Audio Audio] et [page:PositionalAudio PositionalAudio].
+ Dans la plupart des cas, l'objet listener est un enfant de la caméra. Donc la transformation 3D de la caméra représente la transformation 3D du listener.
+
+ // create an AudioListener and add it to the camera
+ const listener = new THREE.AudioListener();
+ camera.add( listener );
+
+ // create a global audio source
+ const sound = new THREE.Audio( listener );
+
+ // load a sound and set it as the Audio object's buffer
+ const audioLoader = new THREE.AudioLoader();
+ audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
+ sound.setBuffer( buffer );
+ sound.setLoop(true);
+ sound.setVolume(0.5);
+ sound.play();
+ });
+
+
+
+ [example:webaudio_sandbox webaudio / sandbox ]
+ [example:webaudio_timing webaudio / timing ]
+ [example:webaudio_visualizer webaudio / visualizer ]
+
+ Crée un nouvel AudioListener. +
+ + +L'[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] du [page:AudioListener listener] passé au constructeur.
+ +Un [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] créé + en utilisant [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().
+ +La valeur par défaut est `null`.
+ +La valeur du delta temporel pour les entités audio. Utilisé dans le contexte [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioParam/linearRampToValueAtTime AudioParam.linearRampToValueAtTimeDefault](). La valeur par défaut est `0`.
+ ++ Renvoie le [page:AudioListener.gain gainNode]. +
+ ++ Assigne la propriété [page:AudioListener.filter filter] à `null`. +
+ ++ Renvoie la valeur de la propriété [page:AudioListener.filter filter]. +
+ ++ Assigne la propriété [page:AudioListener.filter filter] à `value`. +
+ ++ Renvoie le volume. +
+ ++ Modifie le volume. +
+ + ++ [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js] +
+ + diff --git a/docs/api/fr/audio/PositionalAudio.html b/docs/api/fr/audio/PositionalAudio.html new file mode 100644 index 00000000000000..a3b3bbd12d720c --- /dev/null +++ b/docs/api/fr/audio/PositionalAudio.html @@ -0,0 +1,136 @@ + + + + +
+ Crée un objet audio positionnel.
+
+ La [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API] est utilisée.
+
+ // create an AudioListener and add it to the camera
+ const listener = new THREE.AudioListener();
+ camera.add( listener );
+
+ // create the PositionalAudio object (passing in the listener)
+ const sound = new THREE.PositionalAudio( listener );
+
+ // load a sound and set it as the PositionalAudio object's buffer
+ const audioLoader = new THREE.AudioLoader();
+ audioLoader.load( 'sounds/song.ogg', function( buffer ) {
+ sound.setBuffer( buffer );
+ sound.setRefDistance( 20 );
+ sound.play();
+ });
+
+ // create an object for the sound to play from
+ const sphere = new THREE.SphereGeometry( 20, 32, 16 );
+ const material = new THREE.MeshPhongMaterial( { color: 0xff2200 } );
+ const mesh = new THREE.Mesh( sphere, material );
+ scene.add( mesh );
+
+ // finally add the sound to the mesh
+ mesh.add( sound );
+
+
+
+ [example:webaudio_orientation webaudio / orientation ]
+ [example:webaudio_sandbox webaudio / sandbox ]
+ [example:webaudio_timing webaudio / timing ]
+
+ listener — (requis) instance d'[page:AudioListener AudioListener]. +
+ + ++ Voir la classe [page:Audio Audio] pour les propriétés héritées. +
+ +Le [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode PannerNode] du PositionalAudio.
+ + ++ Voir la classe [page:Audio Audio] pour les propriétés héritées. +
+ ++ Renvoie le [page:PositionalAudio.panner panner]. +
+ ++ Renvoie la valeur de [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance]. +
+ ++ Assigne une valeur à [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/refDistance panner.refDistance]. +
+ ++ Renvoie la valeur de [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor]. +
+ ++ Assigne une valeur à [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/rolloffFactor panner.rolloffFactor]. +
+ ++ Renvoie la valeur de [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel]. +
+ ++ Assigne une valeur à [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/distanceModel panner.distanceModel]. +
+ ++ Renvoie la valeur de [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance]. +
+ ++ Assigne une valeur à [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode/maxDistance panner.maxDistance]. +
+ ++ Cette méthode peut être utilisée pour transformer un son omnidirectionnel en un [link:https://developer.mozilla.org/en-US/docs/Web/API/PannerNode son directionnel]. +
+ ++ [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js] +
+ + diff --git a/docs/list.json b/docs/list.json index f7a3d015b87a3a..1efbc0a4aac8fc 100644 --- a/docs/list.json +++ b/docs/list.json @@ -1409,23 +1409,31 @@ "Référence": { "Animation": { - "AnimationAction": "api/pt-br/animation/AnimationAction", - "AnimationClip": "api/pt-br/animation/AnimationClip", - "AnimationMixer": "api/pt-br/animation/AnimationMixer", - "AnimationObjectGroup": "api/pt-br/animation/AnimationObjectGroup", - "AnimationUtils": "api/pt-br/animation/AnimationUtils", - "KeyframeTrack": "api/pt-br/animation/KeyframeTrack", - "PropertyBinding": "api/pt-br/animation/PropertyBinding", - "PropertyMixer": "api/pt-br/animation/PropertyMixer" + "AnimationAction": "api/fr/animation/AnimationAction", + "AnimationClip": "api/fr/animation/AnimationClip", + "AnimationMixer": "api/fr/animation/AnimationMixer", + "AnimationObjectGroup": "api/fr/animation/AnimationObjectGroup", + "AnimationUtils": "api/fr/animation/AnimationUtils", + "KeyframeTrack": "api/fr/animation/KeyframeTrack", + "PropertyBinding": "api/fr/animation/PropertyBinding", + "PropertyMixer": "api/fr/animation/PropertyMixer" }, "Animation / Tracks": { - "BooleanKeyframeTrack": "api/pt-br/animation/tracks/BooleanKeyframeTrack", - "ColorKeyframeTrack": "api/pt-br/animation/tracks/ColorKeyframeTrack", - "NumberKeyframeTrack": "api/pt-br/animation/tracks/NumberKeyframeTrack", - "QuaternionKeyframeTrack": "api/pt-br/animation/tracks/QuaternionKeyframeTrack", - "StringKeyframeTrack": "api/pt-br/animation/tracks/StringKeyframeTrack", - "VectorKeyframeTrack": "api/pt-br/animation/tracks/VectorKeyframeTrack" + "BooleanKeyframeTrack": "api/fr/animation/tracks/BooleanKeyframeTrack", + "ColorKeyframeTrack": "api/fr/animation/tracks/ColorKeyframeTrack", + "NumberKeyframeTrack": "api/fr/animation/tracks/NumberKeyframeTrack", + "QuaternionKeyframeTrack": "api/fr/animation/tracks/QuaternionKeyframeTrack", + "StringKeyframeTrack": "api/fr/animation/tracks/StringKeyframeTrack", + "VectorKeyframeTrack": "api/fr/animation/tracks/VectorKeyframeTrack" + }, + + "Audio": { + "Audio": "api/fr/audio/Audio", + "AudioAnalyser": "api/fr/audio/AudioAnalyser", + "AudioContext": "api/fr/audio/AudioContext", + "AudioListener": "api/fr/audio/AudioListener", + "PositionalAudio": "api/fr/audio/PositionalAudio" } }