Événement Player.ScriptCommand
[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.
Syntaxe
Player.ScriptCommand(
scType,
Param
)
Paramètres
-
scType
-
Chaîne spécifiant le type de commande de script.
-
Param
-
Chaîne spécifiant la commande de script.
Valeur retournée
Cet événement ne retourne pas de valeur.
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é, 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 la DIV spécifiée par ClosedCaption. captioningID. |
| ÉVÉNEMENT | Indique au contrôle d’exécuter 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 rapide du script EVENT. |
| SYNCHRONDLYRICLYRICRIC | Le paramètre Param contient le texte texte synchronisé. Lecteur multimédia Windows affiche le texte 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 la DIV spécifiée par ClosedCaption. captioningID. |
| URL | Le contrôle ouvre automatiquement l’URL spécifiée à l’aide du navigateur Internet par défaut si les Paramètres. la propriété invokeURLs a la valeur true. |
Vous pouvez incorporer n’importe quel autre type de commande tant que vous fournissez du code réciproque 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.
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 les paramètres.la propriété invokeURLs a la valeur true. Vous pouvez utiliser les paramètres. 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 les paramètres.baseURL, propriété. L’URL de base est concaténée avec l’URL relativement spécifiée, 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 entrantes de type URL de la manière suivante :
- Une commande de type URL est reçue.
- Paramètres. baseURL est utilisé pour créer une URL complète à partir de l’URL relative spécifiée dans la commande de script.
- ScriptCommand est appelé.
- Après le retour de ScriptCommand , Paramètres. invokeURLs est vérifié.
- Si Paramètres. invokeURLs a la valeur true et la commande est de type URL, l’URL spécifiée est appelée. Si Paramètres. invokeURLs est false ou si la commande n’est pas de type 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 ampères et le nom de l’image dans le champ de paramètre. L’exemple ci-dessous illustre les paramètres ScriptCommand classiques. Il spécifie que l’URL mypage doit être lancée dans le cadre myframe .
scType = "URL"
Param = https://myweb/mypage.html&&myframe
L’événement ScriptCommand n’est pas appelé si le fichier est en cours d’analyse (transfert rapide ou inversé rapide).
La valeur des paramètres d’événement est spécifiée par Lecteur multimédia Windows et est accessible ou passée à une méthode dans un fichier JScript importé à l’aide du nom de paramètre donné. Ce nom de paramètre doit être tapé exactement comme indiqué, y compris la majuscule.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version |
Lecteur multimédia Windows version 7.0 ou ultérieure. |
| DLL |
|
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour