Depurando código

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Muitas vezes você vai querer ver o que está acontecendo dentro de sua pele. Você pode fazer isso por meio de um controle de texto ou por meio de um arquivo de log.

Você pode criar um elemento TEXT e colocá-lo em uma parte da pele temporariamente. Por exemplo, você pode usar o seguinte código para criar o elemento TEXT :

<!-- debugging control -- remove later -->        
<TEXT
    id = "debug"
    foregroundColor = "white"
    backgroundColor = "black"
    value = "debug"
    top = "100"
    left = "50"
    height = "15"
    width = "100" 
    z-order = "5" />
<!-- end debugging control -->

Em seguida, por exemplo, se você quiser ver a posição atual do conteúdo de mídia digital em Reprodutor Multimídia do Windows, poderá usar um código semelhante ao seguinte para exibir a posição atual na caixa de texto.

<PLAYER
    id = "myplayer">
    <CONTROLS
        id = "mycontrols"
        currentPosition_onchange="value=player.controls.currentPosition"/>
</PLAYER>

Para gravar informações de depuração em um arquivo de log

Para habilitar ou desabilitar a depuração, altere o valor da seguinte chave do Registro:

HKEY_CURRENT_USER\SOFTWARE\Microsoft\MediaPlayer\Preferences\ScriptDebugging

Quando você define o valor como 1, o registro em log é habilitado. Quando você define o valor como 0 (o padrão), o registro em log é desabilitado.

Se o registro em log estiver habilitado, um arquivo será colocado no computador do usuário na mesma pasta que a pele. O arquivo será chamado de "filename_0_log.txt", em que filename é o nome do arquivo de pele. O código em sua pele pode gravar texto nesse arquivo usando o Tema. Método logString . Isso pode ser útil se você quiser determinar o que está acontecendo dentro do código enquanto ele está em execução. Observe que o arquivo de texto é codificado com caracteres Unicode.

Quando o registro em log está habilitado e você instalou um sistema de desenvolvimento que fornece recursos de depuração (como o Microsoft Visual Studio), exceções que não são tratadas pelo código de script farão com que uma caixa de diálogo de aviso do depurador seja aberta para cada exceção. Esse é um recurso útil para ajudá-lo a depurar seu código de script. Além disso, você pode anexar manualmente o processo de Reprodutor Multimídia do Windows ao depurador quando o registro em log estiver habilitado.

Esse SDK inclui uma amostra de pele, chamada "registro em log", que demonstra a funcionalidade de registro em log em skins. Para saber mais sobre como usar os exemplos, consulte Exemplos.

Tópicos relacionados

Sobre skins