Criação de token de conexão — .NET

Para autenticar um usuário que se conecta a uma sessão do OpenTok, o cliente deve se conectar usando um token (consulte esta visão geral).

O código .NET a seguir mostra como gerar um token usando o SDK do OpenTok para .NET:

// Set the following constants with the API key and API secret
// that you receive when you sign up to use the OpenTok API:
OpenTok opentok = new OpenTok(API_KEY, API_SECRET);

//Generate a basic session. Or you could use an existing session ID.
string sessionId = opentok.CreateSession().Id

string token = opentok.GenerateToken(sessionId);

Chamando o GenerateToken() O método retorna uma string. Essa string é o token.

O código .NET a seguir mostra como obter um token com a função “publisher” e que contenha uma string de metadados de conexão:

// Set the following constants with the API key and API secret
// that you receive when you sign up to use the OpenTok API:
OpenTok opentok = new OpenTok(API_KEY, API_SECRET);

//Generate a basic session. Or you could use an existing session ID.
string sessionId = opentok.CreateSession().Id

// Replace with meaningful metadata for the connection.
string connectionMetadata = "username=Bob,userLevel=4";

// Generate a token. Use the Role value appropriate for the user.
string token = opentok.GenerateToken(sessionId, Role.PUBLISHER, Null, connectionMetadata);
=

O método recebe os seguintes argumentos:

  • sessionId (string) — O ID da sessão correspondente à sessão à qual o usuário se conectará.
  • role (string) — Opcional. Define a função que o usuário terá. Existem três funções: assinante, editor e moderador. Os assinantes só podem se inscrever em transmissões na sessão (eles não podem publicar). Os editores podem se inscrever e publicar fluxos na sessão, além de poderem usar a API de sinalização. Os moderadores têm os privilégios dos editores e, além disso, também podem forçar outros usuários a se desconectarem da sessão ou a interromperem a publicação. A função padrão (se nenhum valor for passado) é a de editor.
  • expireTime (int) — Opcional. O momento em que o token expirará, definido como um valor inteiro correspondente a um timestamp do Unix (em segundos). Se você não especificar esse valor, os tokens expiram 24 horas após serem criados. O expireTime O valor, se especificado, deve estar dentro de um intervalo de 30 dias a partir da data de criação.
  • data (string) — Opcional. Uma string contendo metadados que descrevem a conexão. Por exemplo, você pode passar o ID do usuário, o nome ou outros dados que descrevam a conexão. Você pode obter esses dados de um banco de dados do lado do servidor ou a partir de dados fornecidos pelo cliente, dependendo da sua aplicação.