Parâmetros disponíveis

É possível customizar o comportamento da solução de acordo com as descrições abaixo:

Para alterar os comportamentos padrões basta adicionar o caractere ? no final da chamada do script e os parâmetros e os valores desejados na chamada do script rybena.js

Exemplo de chamada do script:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?parametro1=valor1&parametro2=valor2"></script>

Segue abaixo os parâmetros que podem ser utilizados para customizar a ferramenta Rybená

Posição da Rybená em celulares

Esta opção permite escolher a posição do player ao abrir em dispositivos móveis.

positionPlayerMobile: left → Posiciona o Player no lado esquerdo da página.

positionPlayerMobile: right → Posiciona o Player no lado direito da página.

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?positionPlayerMobile=left"></script>

Valor padrão: left

Posição da Barra de Acessibilidade

Esta opção permite escolher se a barra de acessibilidade abrirá a direita ou a esquerda da página.

ATENÇÃO

Esta customização só funciona quando não há uma Barra de acessibilidade customizada.

positionBar: left → Posiciona a barra no lado esquerdo da página.

positionBar: right → Posiciona a barra no lado direito da página.

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?positionPlayer=left&positionBar=right"></script>

Valor padrão: left

Posição da Barra de Acessibilidade (Vertical)

Esta opção permite escolher a posição vertical desejada da barra de acessibilidade

ATENÇÃO

Esta customização só funciona quando não há uma Barra de acessibilidade customizada

offsetTopBar: Valor que determina a distancia entre a barra de acessibilidade e o topo da página → Posiciona a barra na página de acordo com o valor atribuido (Ex: 40%, 100px, 12rem, 30vh).

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?offsetTopBar=30vh"></script>

Valor padrão: 40%

Cor da Barra de Acessibilidade

Esta opção permite escolher a cor da barra de acessibilidade

ATENÇÃO

Esta customização só funciona quando não há uma Barra de acessibilidade customizada

backgroundColorBar: Valor que determina a cor da barra de acessibilidade → Altera a cor da barra de acessibilidade.

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?backgroundColorBar=#316181"></script>

Valor padrão: #316181

Tempo de renderização da barra de acessibilidade

Esta opção permite escolher o tempo para renderização da barra de acessibilidade.

renderTimeout: valor → Altera o tempo de renderização da barra de acessibilidade.

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?renderTimeout=300"></script>

Valor padrão: 0

Valor recomendado: 300

Posição da Rybená nos Eixos da Página

Esta opção permite alterar a posição vertical ou horizontal do Player na página.

offsetX: valor → Altera a posição no eixo X(Horizontal) do Player Rybená.

offsetY: valor → Altera a posição no eixo Y(Vertical) do Player Rybená.

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?offsetX=60&offsetY=60"></script>

Valor padrão: 60

Ordem da pilha da barra de acessibilidade

Esta opção permite alterar a ordem da pilha (eixo z) dos botões da Rybená caso tenha conflito com outros elementos na página

zIndexBar: valor → Altera o z-index da barra de acessibilidade da página.

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?zIndexBar=100"></script>

Barra de acessibilidade customizada

Para usar uma barra customizada, insira as seguintes classes nos elementos desejados, sejam eles, botões (tag button) ou links (tag a).

As classes são:

btn-rybena-sign-language para Libras
btn-rybena-voice para Voz
btn-rybena-visual para + Acessibilidade

Os botões devem estar dentro de uma div, cujo id deve ser custom-rybena-div

Exemplo:

<div id="custom-rybena-div">
    <img alt="" src="" class="btn-rybena-sign-language" />
    <img alt="" src="" class="btn-rybena-voice" />
    <img alt="" src="" class="btn-rybena-vision" />
</div>

APENAS USE ESSAS CONFIGURAÇÕES SE NECESSÁRIO

As configurações avançadas modificam o comportamento do player de forma que ele precisa ser utilizado com api para o funcionamento ideal. Se utilizar tais parâmetros sem implementar a integração por API os usuários não terão uma usabilidade satisfatória

Modo de API

Esta opção automatiza várias funcões para utilizar a Rybená por API

Essas automatizações incluem:

Abertura da Rybená em background
Retirada dos textos de apresentação da Rybená

mode: api → Automatiza algumas funcionalidades para integração facilitada por API
mode: full → Comportamento padrão da Rybená

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?mode=api"></script>

Valor padrão: full

Inicicalizar em outro idioma

Esta opção altera o idioma de inicialização da solução Rybená

lang: ptBR → Inicializa a solução em Português
lang: esES → Inicializa a solução em Espanhol
lang: enUS → Inicializa a solução em Inglês

Exemplo:

<script type="text/javascript" src="https://cdn.rybena.com.br/dom/master/latest/rybena.js?lang=ptBR"></script>

Valor padrão: ptBR

ATENÇÃO

Apenas o idioma Português contém a funcionalidade de tradução em LIBRAS