Usando o Console Multimídia

O Console Multimídia é uma ferramenta que permite o compartilhamento de mídia em eventos e mundos. Você pode usá-lo para compartilhar imagens, Dlive.tv livestreams e vídeos hospedados. Veja abaixo uma instrução passo a passo sobre como usar o Console Multimídia.

Introdução

Introdução ao Console Multimídia é um processo de duas partes. Primeiro, há o portal da Web que você usará para gerar e publicar uma configuração para a sessão do Console Multimídia que você coloca em seu ambiente. Em segundo lugar está o posicionamento do aplicativo console multimídia real em seu ambiente e a configuração do código de configuração que ele deve usar.

Observação

O Console Multimídia não dá suporte a vídeos/livestreams do YouTube, livestreams do Twitch ou links para sites com logons como Google Drive/Dropbox. Ele requer acesso direto a um arquivo de vídeo hospedado publicamente, por exemplo: https://archive.org/download/BigBuckBunny_124/Content/big_buck_bunny_720p_surround.mp4

Configurando o Console Multimídia do portal da Web

  1. Primeiro, você precisará verificar se seu conteúdo está hospedado online porque você precisará de uma URL. Você pode carregar fotos para altvr.com, hospedar um vídeo .mp4 arquivo online ou usar um link de transmissão ao vivo do Dlive: https://dlive.tv/yourlivestream
  2. Navegue até o portal da Web para o Console Multimídia em https://multimedia-console.altvr.com/
  3. No portal da Web, você pode gerar e publicar uma configuração para o Console Multimídia. Veja abaixo detalhes sobre as várias propriedades.
  4. Depois de inserir a mídia na lista de mídia e configurar as configurações gerais, selecione o botão publicar na parte superior direita do aplicativo.
  5. Depois que a publicação for concluída, uma caixa de diálogo aparecerá com um código de duas palavras para você entrar no Console Multimídia que você colocou no AltspaceVR.  

Colocando o Console Multimídia no AltspaceVR

  1. Selecione o Console Multimídia do Painel >> de Editores do Mundo>.
  2. Posicione o Console Multimídia para melhor se adequar ao seu espaço e audiência.
  3. Saia do Modo de Edição clicando no botão Editar Modo laranja.
  4. Você será avisado de que você é o proprietário do player de mídia? Se você for a pessoa que deve ser o proprietário oficial desta sessão do Console Multimídia, confirme e continue. Outras funções permissões também estão disponíveis. Veja abaixo uma lista detalhada.
  5. Selecione Sim para confirmar se você é o host primário.
  6. Uma caixa de diálogo é exibida que solicita que você insira um código do portal da Web ou JSON válido. Insira o código de duas palavras do portal da Web, incluindo o traço e clique em OK. JSON é uma configuração avançada descrita abaixo.
  7. O Console Multimídia será carregado após alguns segundos com a configuração que você criou no portal da Web.

Controlando o Console Multimídia

  1. Depois de inserir seu código de duas palavras/JSON e selecionar OK, você verá os botões de controle aparecerem abaixo da exibição do Console Multimídia.
    • Reproduzir – inicia o visualizador de mídia (ou reinicia na entrada atual, se parado anteriormente)
    • Parar - interrompe o visualizador de mídia e oculta a mídia atual
    • Next/Prev - ignora para a mídia seguinte ou anterior
    • x/x – mostra o índice atual na lista de mídia, permite que você selecione-o para inserir um número para ir para qualquer ponto da lista
    • Configuração – permite que um novo código/JSON defina uma nova configuração no console.

Agora você está pronto para começar a compartilhar por meio do Console Multimídia!

Trabalhando com o portal da Web

O portal da Web é um aplicativo Web que permite configurar os vários recursos do Console Multimídia. Esses recursos se enquadram em duas categorias; configurações gerais do console de mídia e a lista de reprodução de mídia.

Configurações gerais do Console Multimídia

Configurações de reprodução

Configurações gerais de reprodução para a lista de mídia

  • Loop Lista de Mídia- Determina se a lista de mídia deve fazer loop ao redor quando você chegar ao final da lista.
  • Método Start – seleciona o método pelo qual o Console Multimídia deve ser iniciado.
    • Manual – Aguarda o botão reproduzir ser pressionado antes de iniciar a mídia
    • Início Automático do Início – Iniciar automaticamente a lista de mídia desde o início da lista
    • Início Automático Aleatório – Inicia automaticamente a mídia a partir de um ponto de partida aleatório na lista

Funções

Atribuições de função para controlar e configurar o Console Multimídia. Essas funções são divididas no seguinte conjunto:

  • Somente Proprietário – O usuário que é o proprietário da Sessão do Console Multimídia
  • Usuários elevados – usuários que têm funções de moderador ou host no espaço em que o Console Multimídia está configurado originalmente
  • Todos os usuários – todos os usuários

Essas funções são empilhadas no sentido de que todas as funções acima daquela escolhida nesta lista também receberão permissão para usar esse recurso. Exemplo: Usuários elevados incluem o Proprietário mesmo que não sejam um moderador ou host no AltspaceVR.

Os recursos controlados por atribuições de função são os seguintes:

  • Pode controlar o player de mídia - Determina quais funções podem controlar os botões de reprodução de mídia para o Console Multimídia
  • Pode configurar o player de mídia – Determina quais funções podem configurar o Console Multimídia ao receber acesso ao botão Configuração

Adicionando fotos e vídeos à lista de mídia

A mídia é o coração do Console Multimídia. Há suporte para imagens e links de vídeo como tipos de mídia no Console Multimídia. Para adicionar novas mídias, selecione os ícones Adicionar Imagem ou Adicionar Vídeo para que uma caixa de diálogo apareça para inserir as informações de mídia e as configurações. Abaixo está a divisão dos tipos de mídia e configurações associadas:

Imagem

As imagens devem ser um tipo de imagem padrão, como jpeg, png e son on. O dimensionamento 1920x1080 funciona muito bem. Eles precisam ser hospedados em algum lugar com um link público.

  • Nome – (Obrigatório) Nome com o qual você deseja identificar a imagem
  • URL da imagem – (Obrigatório) A URL pública da imagem
  • Ignorar Após - O número de segundos que a imagem deve ser ignorada após

Vídeo

Os vídeos podem ser hospedados em vídeos ou transmissões ao vivo por meio do DLive. Outras formas de reprodução podem funcionar com trabalho extra para obter a URL de fluxo adequada, mas não têm suporte total no Console Multimídia.

  • Nome – (Obrigatório) Nome com o qual você deseja identificar o vídeo
  • URL de vídeo – (Obrigatório) A URL pública na qual o vídeo está hospedado ou o livestream é servido de
  • Ignorar Após - O número de segundos que o vídeo deve ser ignorado após

Observação

OBRIGATÓRIO: coloque o tempo que corresponde ao comprimento do vídeo para permitir que os vídeos pulem corretamente para a próxima parte do conteúdo. Por exemplo, se o vídeo tiver 5 minutos de duração, caso contrário, o vídeo não pulará para a próxima parte do conteúdo.

  • Volume – O volume do vídeo de 0 (min) – 1 (máximo) valores
  • Hora de Início – O número de segundos do início do vídeo para começar
  • Distância inicial de roll off – a distância, em metros, que o volume começa a cair à medida que você se afasta do Console Multimídia
  • Fim da Ação de Vídeo – A ação a ser executada quando o final do vídeo for atingido:
    • Parar - A lista de mídia é interrompida após o término do vídeo
    • Loop - O vídeo será loop até ser ignorado manualmente
    • Reproduzir Próximo – A próxima mídia na lista de mídia será iniciada após o término do vídeo atual

Trabalhando diretamente com JSON (opcional)

O Console Multimídia dá suporte à inserção de JSON diretamente no prompt do console no AltspaceVR. JSON é o mecanismo interno com o qual habilitamos as configurações do player de mídia. Expor a capacidade de definir o JSON diretamente é algo que permite que usuários mais avançados criem seus próprios fluxos de trabalho que incluem suas necessidades e familiaridade com o JSON. Veja a seguir uma breve descrição da estrutura JSON e do esquema pelo qual o JSON é validado. Para obter descrições mais detalhadas das propriedades abaixo, consulte as seções acima que falam sobre como configurar o Console Multimídia. Esta seção se concentra principalmente nos exemplos de esquema e na estruturação para os dados JSON.

Configurações de mídia global

{
  "loopMediaList": true | false
  "startMethod": "manual" | "autostart-beginning" | "autostart-random"
  "controlMediaPlayer": "everyone" | "elevated" | "owner"
  "configureMediaPlayer": "elevated" | "owner"
  ...
}

Lista de mídia

A lista de mídia é uma propriedade definida na raiz da estrutura JSON, como o Configurações Funções e Reprodução. É uma matriz simples que pode conter uma das seguintes estruturas de configuração de mídia. (Consulte as descrições de propriedade acima para obter detalhes sobre o que cada um faz.)

Exemplo de imagem

Campos necessários: "name" e "imageUrl"

{
    "name": "AltspaceVR 2D Controls",
    "imageUrl": "https://cdn-content-ingress.altvr.com/uploads/photo/image/1832152198230835586/keyboard-mouse-controls.png",
    "skipAfter": 10
}

Exemplo de vídeo

Campos necessários: "name" e "videoUrl"

{
    "name": "DLive Livestream",
    "videoUrl":"https://www.dlive.tv/Laura-Lynn",
    "volume":0.2,
    "startTime":0,
    "endOfVideoAction":"play-next"
}

JSON de exemplo

{
  "loopMediaList": false,
  "startMethod": "autostart-beginning",
  "controlMediaPlayer": "everyone",
  "configureMediaPlayer": "elevated",
  "mediaList": [
    {
      "videoUrl": "https://www.dlive.tv/Laura-Lynn",
      "volume": 0.2,
      "startTime": 0,
      "endOfVideoAction": "play-next"
    },
    {
      "imageUrl": "https://cdn-content-ingress.altvr.com/uploads/photo/image/1832152198230835586/keyboard-mouse-controls.png",
      "skipAfter": 10
    },
    {
      "imageUrl": "https://cdn-content-ingress.altvr.com/uploads/photo/image/1706194600978285229/Untitled-1.png",
      "skipAfter": 10
    }
  ]
}

Esquema (avançado)

{
  "$schema": "https://json-schema.org/draft-04/schema#",
  "type": "object",
  "required": [
    "mediaList"
  ],
  "properties": {
    "loopMediaList": {
      "type": "boolean",
      "description": "Whether to loop through the media list when reaching the beginning or end of the list."
    },
    "controlMediaPlayer": {
      "type": "string",
      "enum": [
        "everyone",
        "elevated",
        "owner"
      ],
      "default": "owner",
      "description": "What roles are able to control the media player. (Owner can always control player)"
    },
    "configureMediaPlayer": {
      "type": "string",
      "enum": [
        "elevated",
        "owner"
      ],
      "default": "owner",
      "description": "What roles are allowed to configure the media play list.  Note: This role needs to be able to control the media player in order to configure it. (Owner can always configure media)"
    },
    "startMethod": {
      "type": "string",
      "enum": [
        "manual",
        "autostart-beginning",
        "autostart-random"
      ],
      "default": "manual",
      "description": "The method by which the media player should start"
    },
    "mediaList": {
      "description": "A list of images or videos to configure the media player to operate on.",
      "type": "array",
      "items": {
        "oneOf": [
          {
            "title": "Image",
            "type": "object",
            "description": "Configuration for an image media.",
            "properties": {
              "imageUrl": {
                "type": "string",
                "description": "The url for the image to load."
              },
              "skipAfter": {
                "type": "number",
                "minimum": 5,
                "default": null,
                "description": "The number of seconds that should pass before skipping to the next media. (Minimum 5)."
              }
            },
            "required": [
              "imageUrl"
            ]
          },
          {
            "title": "Video",
            "type": "object",
            "description": "Configuration for a video media.",
            "properties": {
              "videoUrl": {
                "type": "string",
                "description": "The url of the video to load."
              },
              "skipAfter": {
                "type": "number",
                "minimum": 5,
                "default": null,
                "description": "The number of seconds that should pass before skipping to the next media. (Minimum 5)."
              },
              "volume": {
                "type": "number",
                "minimum": 0,
                "maximum": 1,
                "default": null,
                "description": "The volume to play the video at. (Minimum 0, maximum 1)"
              },
              "startTime": {
                "type": "number",
                "minimum": 0,
                "default": null,
                "description": "The time in seconds from the start of the video to begin playing the video at. (Minimum of 0)"
              },
              "rolloffStartDistance": {
                "type": "number",
                "minimum": 0,
                "default": null,
                "description": "The distance in meters away from the media player that the volume will begin to fall off. (Minimum 0)"
              },
              "endOfVideoAction": {
                "type": "string",
                "enum": [
                  "stop",
                  "loop",
                  "play-next"
                ],
                "default": null,
                "description": "The type of action to take at the end of the video."
              }
            },
            "required": [
              "videoUrl"
            ]
          }
        ]
      }
    }
  }
}