Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

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.value
Représente le paramètre courant à valeur à virgule flottante. Initialement, il est fixé à la valeur de AudioParam.defaultValue. Même si elle peut être réglée, toute modification qui se passe alors qu'il ya des événements d'automatisation prévue - c'est événements programmés en utilisant les méthodes de la AudioParam - sont ignorés, sans soulever aucune exception
AudioParam.defaultValue Lecture seule
Représente la valeur initiale des attributs tels que définis par le spécifique AudioNode qui crée le AudioParam.

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.
Working Draft  

Compatibilité des navigateurs

Fonctionalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support basique (Oui)webkit Actif seulement sur Nightly Pas de support Pas de support ?
Fonctionalité Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Support basique Pas de support Actif seulement sur Nightly Pas de support Pas de support ?

Voir aussi

  • Utilisez Web Audio

Étiquettes et contributeurs liés au document

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