Événement ScriptCommand de l’objet AxWindowsMediaPlayer

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’événement ScriptCommand se produit lorsqu’une commande ou une URL synchronisée est reçue.

[C#]
private void player_ScriptCommand(
  object sender,
  _WMPOCXEvents_ScriptCommandEvent e
)

[Visual Basic]
Private Sub player_ScriptCommand(  
  sender As Object, 
  e As _WMPOCXEvents_ScriptCommandEvent
) Handles player.ScriptCommand

Données d'événements

Le gestionnaire associé à cet événement est de type AxWMPLib._WMPOCXEvents_ScriptCommandEventHandler. Ce gestionnaire reçoit un argument de type AxWMPLib._WMPOCXEvents_ScriptCommandEvent, qui contient les propriétés suivantes liées à cet événement.

Propriété	Description
scType	System.String Spécifie le type de commande de script.
param	System.StringSpécifie la commande de script.

Notes

Les commandes peuvent être incorporées dans les sons et les images d’un fichier ou d’un flux Windows Media. Les commandes sont une paire de chaînes Unicode associées à une heure désignée dans le flux. Lorsque le flux atteint l’heure associée à la commande, le contrôle Lecteur multimédia Windows envoie un événement ScriptCommand avec deux paramètres. Un paramètre spécifie le type de commande envoyée, et l’autre paramètre spécifie la commande. Le type de paramètre est utilisé pour déterminer comment le paramètre de commande est traité. N’importe quel type de commande peut être incorporé dans un fichier ou un flux à gérer par l’événement ScriptCommand .

Le tableau suivant répertorie les types de commandes de script qui sont traités automatiquement par Lecteur multimédia Windows.

Type	Description
CAPTION	Le contrôle affiche le texte associé dans l’élément HTML spécifié par IWMPClosedCaption. captioningId.
ÉVÉNEMENT	Le contrôle exécute les instructions définies pour l’événement spécifié.
FICHIER	Le contrôle réinitialise sa propriété URL , tente d’ouvrir le fichier spécifié et commence immédiatement à lire le nouveau flux.
OPENEVENT	Met en mémoire tampon la commande de type EVENT associée pour une exécution en temps opportun du script EVENT.
SYNCHRONIZEDLYRICLYRICRIC	Le paramètre param contient le texte lyrique synchronisé. Lecteur multimédia Windows affiche le texte dans la zone de légende fermée de la fonctionnalité En cours de lecture.
TEXT	Le contrôle affiche le texte associé dans l’élément HTML spécifié par IWMPClosedCaption. captioningId.
URL	Le contrôle ouvre automatiquement l’URL spécifiée à l’aide du navigateur Internet par défaut si IWMPSettings. La propriété invokeURLs a la valeur true.

Vous pouvez incorporer n’importe quel autre type de commande tant que vous fournissez du code pour gérer la commande. Bien que les commandes inconnues soient ignorées par le contrôle Lecteur multimédia Windows, elles sont toujours transmises à l’événement ScriptCommand.

L’événement ScriptCommand n’est pas appelé si le fichier est analysé en mode avance rapide ou rembobinage.

Les commandes d’URL reçues par le contrôle Lecteur multimédia Windows sont appelées automatiquement dans votre navigateur Web par défaut si IWMPSettings.La propriété invokeURLs a la valeur true. Vous pouvez utiliser IWMPSettings. propriété defaultFrame pour spécifier le cadre cible dans lequel la page web s’affiche.

L’URL envoyée à Lecteur multimédia Windows est traitée par rapport à l’URL de base spécifiée par IWMPSettings.baseURL, propriété. L’URL de base est concaténée avec l’URL relative, ce qui entraîne une URL entièrement spécifiée qui est passée en tant que paramètre de commande par l’événement ScriptCommand .

Le contrôle Lecteur multimédia Windows traite toujours les commandes URL entrantes de la manière suivante :

1. Une commande de type URL est reçue.
2. IWMPSettings. baseURL est utilisé pour créer une URL complète à partir de l’URL relative spécifiée dans la commande de script.
3. ScriptCommand est appelé.
4. Une fois que ScriptCommand est retourné, IWMPSettings. invokeURLs est coché.
5. Si IWMPSettings. invokeURLs a la valeur true et la commande est une commande d’URL, l’URL spécifiée est appelée. Si IWMPSettings. invokeURLs a la valeur false ou si la commande n’est pas une commande d’URL, la commande est ignorée.

Lors de la création d’un fichier Windows Media, vous pouvez spécifier l’image dans laquelle la nouvelle URL s’affiche en concaténant deux esperluette et le nom du frame dans le champ de paramètre. L’exemple suivant illustre les paramètres ScriptCommand standard. Il spécifie que l’URL mypage doit être lancée dans le frame myframe .

scType = "URL"
Param = https://myweb/mypage.html&&myframe

L’événement ScriptCommand n’est pas appelé si le fichier est analysé (transfert rapide ou rewound).

Configuration requise

Condition requise	Valeur
Version	série Lecteur multimédia Windows 9 ou ultérieure
Espace de noms	AxWMPLib
Assembly	AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

Voir aussi

Objet AxWindowsMediaPlayer (VB et C#)

AxWindowsMediaPlayer.URL (VB et C#)

IWMPClosedCaption.captioningId (VB et C#)

IWMPSettings.baseURL (VB et C#)

IWMPSettings.defaultFrame (VB et C#)

IWMPSettings.invokeURLs (VB et C#)