PlayFile
Início  Anterior  Próximo



Inicia a reprodução de um arquivo através da placa.

Declarações:
 
Delphi:  
function PlayFile(Port: Smallint; const File_,   
TermDigits: WideString; Origin: integer): Smallint;  
Visual Basic:  
Function PlayFile(Port As Integer, File As String,   
         TermDigits As String, Origin as Integer) As Integer  
 
Descrição:

O método PlayFile inicia a reprodução de um arquivo através da placa. É possível programar a interrupção através de um ou mais dígitos recebidos através do parâmetro TermDigits. Ao iniciar a reprodução o evento OnPlayStart é gerado e o evento OnPlayStrop ao término, indicando o motivo da interrupção. É possível interromper também manualmente através do método StopRecordFile.

O PlayFile detecta automaticamente o tipo de arquivo, baseado na extensão para .sig, .gsm e se for wave, detecta se é PCM ou LeiMi. Isso permite uso de diversos formatos para reprodução sem preocupação para o programador. Se for utilizado uma extensão desconhecida, fica valendo o que está especificado no SetPlayFormat.

Parâmetros:

File – String contendo o nome e caminho completo do arquivo SIG a ser reproduzido.  
TermDigits – É uma string contendo um ou mais dígitos, que ao serem detectados finaliza a reprodução das mensagens e gera os eventos OnPlayStop e OnDigitsReceived. Se qualquer dígito puder interromper utilize o símbolo "@". Se não houver dígito finalizador, passar "" (vazio).  
Origin - Este parâmetro permite reproduzir a mensagem a partir de um determinado ponto. Se for passado 0 (zero) a mensagem é reproduzida do início. Se for passado -1 a mensagem é reproduzida a partir do final menos 2 segundos (ideal para ouvir em real-time). Qualquer número diferente de 0 e -1 significa a partir de quantos segundos a mensagem será reproduzida.  

Valor de Retorno:
Retorna zero se foi iniciado com sucesso ou 1 no caso de erro.