AudioParam

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

L'interface AudioParam représente un paramètre lié à audio, comme un AudioNode, il peut être réglé à une valeur spécifique ou une variation de valeur peut être programée à un moment spécifique et suivant une logique spécifique.

Il ya deux sortes de AudioParam, avec comme paramètres, a-rate et k-rate :

  • Un a-rate AudioParam prend la valeur actuelle du paramètre audio pour chaque trame d'échantillons du signal audio.
  • Un k-rate AudioParam utilise la même valeur de paramètre audio initial pour l'ensemble du bloc traité, c'est-à-dire 128 échantillonnages.

Chaque AudioNode définit lequel de ses paramètres sont a-rate ou k-rate.

Chaque AudioParam a une liste d'événements, initialement vide, qui définit quand et comment les valeurs changent. Lorsque cette liste si elle n'est pas vide, change en utilisant AudioParam.value, les attributs sont ignorés. Cette liste d'événements permet de planifier les changements qui doivent se produire à des moments très précis à l'aide de courbes d'automatisation timelime basés arbitraires. L'heure utilisée est celle définie par AudioContext.currentTime.

Propriétés

Hérite des propriétés de son parent, AudioNode.

AudioParam.defaultValue Lecture seule
Volume initial tel que défini par l'AudioNode qui crée l'AudioParam.
AudioParam.maxValue Lecture seule
Valeur maximum. 
AudioParam.minValue Lecture seule
Valeur minimum. 
AudioParam.value
Volume, exprimé sous forme de valeur à virgule flottante. Initialement, il est fixé à la valeur de AudioParam.defaultValue. Même s'il peut être modifié, toute modification qui a lieu alors que des événements d'automatisation sont prévus - événements programmés en utilisant les méthodes de la AudioParam - est ignorée, sans lever aucune exception

Méthodes

Hérite des propriétés de son parent, AudioNode.

AudioParam.setValueAtTime()
Planifie un changement de la valeur d' AudioParam à un moment précis, startTime, tel que défini par AudioContext.currentTime. La nouvelle valeur est donnée par le paramètre de valeur.
AudioParam.linearRampToValueAtTime()
Planifie un changement de la valeur d'AudioParam. Le changement commence à l'heure prévue pour l'événement précédent, suit une rampe linéaire jusqu'à la nouvelle valeur, donnée par le paramètre de valeur et atteint la nouvelle valeur à l'heure indiquée par le paramètre endTime.
AudioParam.exponentialRampToValueAtTime()
Planifie un changement de la valeur d'AudioParam. Le changement commence à l'heure prévue pour l'événement précédent, suite à une rampe exponentielle jusqu'à la nouvelle valeur, donnée par le paramètre de valeur et atteint la nouvelle valeur à l'heure indiquée par le paramètre endTime.
Les rampes exponentielles sont utiles lors du changement de fréquences ou des taux de lecture en raison de la façon dont l'oreille humaine fonctionne.
AudioParam.setTargetAtTime()
Planifie le début d'un changement de la valeur d'AudioParam. Le changement commence à l'heure spécifiée, startTime et de façon exponentielle tend vers la valeur donnée par le paramètre target. Le taux de décroissance exponentielle est définie par le paramètre timeConstant. C'est le temps nécessaire à un système continu linéaire du premier ordre invariant dans le temps pour atteindre la valeur de 1 - 1 / e (environ 63,2%) donné une réponse d'entrée de l'étape (passage de 0 à 1 en valeur), Plus il est grand, plus la transition sera facile. Ceci est utile pour la décroissance ou la libération de portions d'enveloppes.
AudioParam.setValueCurveAtTime()
Planifie des valeurs de AudioParam à suivre un jeu de valeurs, définie par les valeurs Float32Array, mises à l'échelle pour s'adapter dans l'intervalle donné, à partir de startTime et ayant une duration spécifique.
AudioParam.cancelScheduledValues()
Annule toutes les modifications futures prévues du AudioParam.

Spécifications

Spécification Statut Commentaire
Web Audio API
La définition de 'AudioParam' dans cette spécification.
Version de travail  

Compatibilité des navigateurs

Fonctionalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support basique 14.0 webkit 23 (23) Pas de support 15 webkit
22 (unprefixed)
6 webkit
Unprefixed (Oui)     (Oui)  
minValueandmaxValue 52.0     39  
Fonctionalité Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile Chrome for Android
Support basique Pas de support (Oui) 25.0 (25) 1.2 Pas de support Pas de support 6 webkit 28.0 webkit
Unprefixed Pas de support (Oui)       (Oui)   (Oui)
minValue and maxValue Pas de support 52.0       39   52.0

Voir aussi

  • Utilisez Web Audio

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : marie-ototoi, fscholz, tregagnon, dexterneo
 Dernière mise à jour par : marie-ototoi,