Depuração — Web
Este tópico inclui as seguintes seções:
- Registro no console
- Teste de múltiplas conexões de clientes em uma única máquina
- Utilização de manipuladores de conclusão
- Monitoramento de eventos de exceção
- Sessões de solução de problemas com o Inspector
- Como reproduzir problemas no OpenTok Playground
- Como relatar um problema
Registro no console
Ao desenvolver seu aplicativo, insira o código abaixo em algum lugar do seu aplicativo. Isso gerará mais saídas de log no console, permitindo que você acompanhe melhor o funcionamento do seu programa e entenda o que está acontecendo nos bastidores.
OT.setLogLevel(OT.DEBUG);
Você também pode registrar mensagens no console chamando a função OT.log() método:
OT.log("my session ID: " + session.sessionId);
(Ligar para OT.setLogLevel(OT.DEBUG) ou OT.setLogLevel(OT.LOG) antes de ligar OT.log().)
Teste de múltiplas conexões de clientes em uma única máquina
Não é possível se inscrever em um stream que você mesmo publicou na mesma página do navegador. No entanto, você pode abrir a página em uma segunda aba (ou janela do navegador) e se inscrever no stream publicado na outra aba (ou janela).
Utilização de manipuladores de conclusão
Em muitos métodos que são executados de forma assíncrona, o último parâmetro passado é uma função de tratamento de conclusão. Essa função é chamada quando o método é concluído ou falha. Se houver falha, é passado à função um objeto de erro como parâmetro.
Por exemplo, o código a seguir chama o método Session.connect(), passando um manipulador de conclusão:
var session = OT.initSession(apiKey, session);
session.connect(token, function (error) {
if (error) {
if (error.name === "OT_NOT_CONNECTED") {
alert("You are not connected to the internet. Check your network connection.");
}
console.log("Failed to connect: ", error.message);
} else {
console.log("Connected");
}
});
Para obter mais informações, consulte Tratamento de exceções.
Monitoramento de eventos de exceção
Para detectar todos os eventos de exceção, adicione um ouvinte de eventos para o exception evento, disparado pelo objeto OT. No entanto, é mais fácil reagir a erros nos manipuladores de conclusão de métodos específicos. Consulte Tratamento de exceções.
// Listen for exceptions
OT.on("exception", function(event) {
console.log(event.message);
}
Sessões de solução de problemas com o Inspector
Inspetor fornece informações de diagnóstico pós-evento sobre sessões do OpenTok. Insira um ID de sessão ou um ID de problema relatado (consulte o próxima seção) no Inspector para visualizar as informações brutas nos níveis de fluxo e de usuário, a fim de ajudar a identificar erros, falhas e problemas de qualidade.
Para mais detalhes, consulte o Documentação do Inspector.
Como reproduzir problemas no OpenTok Playground
Parque infantil utiliza o SDK do OpenTok.js para acessar a plataforma OpenTok e ajuda você a reproduzir os problemas encontrados durante a implantação.
Para mais detalhes, consulte o Documentação do Playground.
Como relatar um problema
Você pode ligar para o OT.reportIssue() método para relatar programaticamente quando seu aplicativo apresentar um problema. Esse método fornece um ID do problema, que você pode usar com o Inspetor ou ao discutir o assunto com a equipe de suporte da API da Vonage.
OT.reportIssue(function(error, issueId) {
if (error) {
console.log(error);
} else {
console.log(issueId);
// You may want to use XMLHttpRequest to report this issue ID to a server
// that can store it in a database for later reference.
}
});
O OT.reportIssue() O método recebe um parâmetro, uma função de manipulador de conclusão, que é chamada quando a chamada para OT.reportIssue() seja bem-sucedida ou falhe. A função de tratamento de conclusão possui dois parâmetros. O primeiro parâmetro é um objeto de erro que é definido quando a chamada para o reportIssue() o método falhar (por exemplo, se o cliente não estiver conectado à rede) ou null quando a chamada para o reportIssue() O método é executado com sucesso. O segundo parâmetro é definido com o ID do problema relatado (uma sequência de caracteres exclusiva) quando a chamada é bem-sucedida.