Share via


AudioTrack.Play Méthode

Définition

Démarre la lecture d’un AudioTrack.

[Android.Runtime.Register("play", "()V", "GetPlayHandler")]
public virtual void Play ();
[<Android.Runtime.Register("play", "()V", "GetPlayHandler")>]
abstract member Play : unit -> unit
override this.Play : unit -> unit
Attributs

Exceptions

si la piste n’est pas correctement initialisée

Remarques

Démarre la lecture d’un AudioTrack.

Si le mode de création de la piste est #MODE_STATIC, vous devez avoir appelé l’une des méthodes d’écriture (#write(byte[], int, int), , #write(byte[], int, int, int)#write(short[], int, int), #write(short[], int, int, int), #write(float[], int, int, int)ou #write(ByteBuffer, int, int)) avant play().

Si le mode est #MODE_STREAM, vous pouvez éventuellement amorcer le chemin des données avant d’appeler play(), en écrivant jusqu’à bufferSizeInBytes (à partir du constructeur). Si vous n’appelez pas write() en premier, ou si vous appelez write() mais avec une quantité de données insuffisante, la piste sera dans l’état de sous-exécution à la lecture(). Dans ce cas, la lecture ne démarre pas réellement tant que le chemin des données n’est pas rempli à un niveau minimal spécifique à l’appareil. Cette exigence pour que le chemin d’accès soit rempli à un niveau minimal est également vraie lors de la reprise de la lecture audio après l’appel de stop(). De même, la mémoire tampon doit être remplie à nouveau après la sous-exécution de la piste en raison d’un échec d’appel de write() en temps opportun avec suffisamment de données. Pour la portabilité, une application doit amorcer le chemin d’accès aux données au maximum autorisé en écrivant des données jusqu’à ce que la méthode write() retourne un nombre de transferts court. Cela permet à play() de démarrer immédiatement et réduit le risque de sous-exécution.

À partir du android.os.Build.VERSION_CODES#S niveau minimal pour commencer à jouer peut être obtenu à l’aide de #getStartThresholdInFrames() et défini avec #setStartThresholdInFrames(int).

Documentation Java pour android.media.AudioTrack.play().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le Open Source Project et utilisés selon les termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à