Ação Executar comando utilitário
A ação Executar comando utilitário executa o PlayIt CLI integrado – PlayIt.Cli.exe, localizado na pasta PlayIt.Cli da sua instalação do PlayIt Live – com os parâmetros que você fornecer. Ela é tipicamente usada como etapa em um evento agendado para colocar arquivos de áudio ou de log no lugar correto, por exemplo, copiando a gravação mais recente para uma pasta ou baixando arquivos de um servidor FTP, antes que outra ação os importe.
Parâmetros
- Nome – um rótulo para o comando que permite reconhecê-lo na lista de ações.
- Parâmetros – a linha de comando passada para o PlayIt CLI: o nome do comando seguido de suas opções (veja abaixo).
- Aguardar conclusão – quando marcado, o evento agendado aguarda o término do comando antes de executar a próxima ação. Marque esta opção quando uma ação posterior depender da presença do arquivo.
Cada comando registra seu progresso no log de eventos, e os arquivos são copiados ou baixados por meio de um arquivo temporário que é renomeado para o local definitivo após a conclusão, de modo que um arquivo parcialmente escrito nunca será detectado por uma pasta monitorada.
Comandos disponíveis
copy-file
Copia um único arquivo para outro local.
| Opção | Obrigatório | Descrição |
|---|---|---|
--source | Sim | O caminho do arquivo de origem. |
--destination | Sim | A pasta de destino ou um caminho de arquivo completo. Pastas inexistentes são criadas. |
copy-file --source "C:\Recordings\latest.mp3" --destination "D:\Playout\Imports"copy-newest-file
Copia o arquivo mais recente de uma pasta para outro local. Útil quando um sistema externo grava um novo arquivo a cada vez e você precisa apenas do mais recente.
| Opção | Obrigatório | Descrição |
|---|---|---|
--source | Sim | A pasta de origem. |
--destination | Sim | A pasta de destino ou um caminho de arquivo completo. |
--filter | Não | Um filtro com caracteres curinga para determinar quais arquivos considerar, por exemplo *.mp3. |
--regex-filter | Não | Um filtro de expressão regular, por exemplo Part [0-9]+. |
--strategy | Não | Como o "mais recente" é determinado: LastModifiedDate (padrão), CreatedDate ou FileNameAlpha (ordem alfabética inversa – útil quando os arquivos são nomeados em um formato ordenável como YYYYMMDDHHMMSS). |
copy-newest-file --source "C:\Incoming\News" --destination "D:\Playout\News.mp3" --filter *.mp3download-ftp-file
Baixa um único arquivo de um servidor FTP ou FTPS.
| Opção | Obrigatório | Descrição |
|---|---|---|
--host | Sim | O nome do host do servidor. |
--port | Não | O número da porta (padrão 21). |
--username | Não | O nome de usuário. |
--password | Não | A senha. |
--remote-file-path | Sim | O caminho do arquivo no servidor. |
--local-file-path | Sim | Onde salvar o arquivo localmente. |
--encryption-mode | Não | Para FTPS: None (padrão), Implicit, Explicit ou Auto. |
download-ftp-file --host ftp.example.com --username user --password pass --remote-file-path /news/bulletin.mp3 --local-file-path "D:\Playout\bulletin.mp3"download-ftp-directory
Baixa os arquivos em um diretório de um servidor FTP ou FTPS.
| Opção | Obrigatório | Descrição |
|---|---|---|
--host | Sim | O nome do host do servidor. |
--port | Não | O número da porta (padrão 21). |
--username | Não | O nome de usuário. |
--password | Não | A senha. |
--remote-directory-path | Sim | O diretório remoto a ser baixado. |
--local-directory-path | Sim | A pasta local para a qual os arquivos serão baixados. |
--filter | Não | Um filtro com caracteres curinga para determinar quais arquivos baixar, por exemplo *.mp3. |
--regex-filter | Não | Um filtro de expressão regular. |
--encryption-mode | Não | Para FTPS: None (padrão), Implicit, Explicit ou Auto. |
download-ftp-directory --host ftp.example.com --username user --password pass --remote-directory-path /adverts --local-directory-path "D:\Playout\Adverts" --filter *.mp3Combine esta ação com uma pasta monitorada ou com uma ação Inserir/Importar log/playlist externo para importar automaticamente o áudio copiado ou baixado para sua biblioteca ou Playout Log.