Herdado de: : Object

Definido em: : lib/opentok/captions.rb

Visão geral

Uma classe para trabalhar com legendas do OpenTok.

Resumo dos métodos de instância

Detalhes do método de instância

#início(session_id, token, options = {}) ⇒ Objeto

Ativa as legendas em tempo real para a sessão do OpenTok especificada. Consulte o / Guia do desenvolvedor do OpenTok Live Captions.

Exemplos:

opts = { "language_code" => "en-GB",
         "max_duration" => 5000,
         "partial_captions" => false,
         "status_callback_url" => status_callback_url
       }
response = opentok.captions.start(session_id, token, opts)

Parâmetros:

  • session_id (String) —

    O ID da sessão correspondente à sessão na qual as legendas serão exibidas.

  • token (String) —

    O token correspondente ao ID da sessão que o usuário SIP utilizará para se conectar.

  • opções (Hash) (valor padrão: {})

    Um hash que define as opções para as legendas. Por exemplo:

Hash de opções (options):

  • :language_code (String)

    O código BCP-47 do idioma falado utilizado nesta chamada. O valor padrão é “en-US”. São suportados os seguintes códigos de idioma:

    - "en-AU" (English, Australia)
    - "af-ZA" (Afrikaans))
    - "ar-AE" (Arabic, Gulf)
    - "ar-SA" (Arabic, Modern Standard)
    - "eu-ES" (Basque)
    - "ca-ES" (Catalan)
    - "zh-HK" (Chinese, Simplified)
    - "zh-CN" (Chinese, Cantonese)
    - "zh-TW" (Chinese, Traditional)
    - "hr-HR" (Croatian)
    - "cs-CZ" (Czech)
    - "da-DK" (Danish)
    - "nl-NL" (Dutch)
    - "en-AU" (English, Australian)
    - "en-GB" (English, British)
    - "en-IN" (English, Indian)
    - "en-IE" (English, Irish)
    - "en-NZ" (English, New Zealand)
    - "en-AB" (English, Scottish)
    - "en-ZA" (English, South African)
    - "en-US" (English, US)
    - "en-WL" (English, Welsh)
    - "fa-IR" (Farsi)
    - "fi-FI" (Finnish)
    - "fr-FR" (French)
    - "fr-CA" (French, Canadian)
    - "gl-ES" (Galician)
    - "de-DE" (German)
    - "de-CH" (German, Swiss)
    - "el-GR" (Greek)
    - "he-IL" (Hebrew)
    - "hi-IN" (Hindi, Indian)
    - "id-ID" (Indonesian)
    - "it-IT" (Italian)
    - "ja-JP" (Japanese)
    - "ko-KR" (Korean)
    - "lv-LV" (Latvian)
    - "ms-MY" (Malay)
    - "no-NO" (Norwegian Bokmål)
    - "pl-PL" (Polish)
    - "pt-PT" (Portuguese)
    - "pt-BR" (Portuguese, Brazilian)
    - "ro-RO" (Romanian)
    - "ru-RU" (Russian)
    - "sr-RS" (Serbian)
    - "sk-SK" (Slovak)
    - "so-SO" (Somali)
    - "es-ES" (Spanish)
    - "es-US" (Spanish, US)
    - "sv-SE" (Swedish)
    - "tl-PH" (Tagalog/Filipino)
    - "th-TH" (Thai)
    - "uk-UA" (Ukrainian)
    - "vi-VN" (Vietnamese)
    - "zu-ZA" (Zulu
    
  • :max_duration (Número inteiro)

    A duração máxima da legenda de áudio, em segundos. O valor padrão é 14.400 segundos (4 horas), que é a duração máxima permitida.

  • :partial_captions (Booleano)

    Se deve habilitar essa função para agilizar a geração de legendas, mesmo que isso acarrete um certo grau de imprecisão. O valor padrão é “true”.

  • :status_callback_url (String)

    Um URL acessível ao público, controlado pelo cliente e capaz de gerar o conteúdo a ser exibido sem a intervenção do usuário. O comprimento mínimo do URL é de 15 caracteres e o máximo é de 2.048 caracteres. Para obter mais informações, consulte Atualizações do status das legendas em tempo real.

#pare(captions_id) ⇒ Objeto

Ativa as legendas em tempo real para a sessão do OpenTok especificada. Consulte o / Guia do desenvolvedor do OpenTok Live Captions.

Exemplos:

response = opentok.captions.stop(captions_id)

Parâmetros:

  • captions_id (String) —

    O ID das legendas a serem interrompidas (retornado pela solicitação “start”).