De multimediaconsole gebruiken

Artikel
08/17/2021
8 minuten om te lezen

De multimediaconsole is een hulpprogramma waarmee media kunnen worden gedeeld in gebeurtenissen en wereld. U kunt het gebruiken om dingen zoals afbeeldingen, presentatiedia's, livestreams, video's, afspeellijsten en meer te delen. Hieronder vindt u stapsgewijs instructies voor het gebruik van de multimediaconsole v0.5.0+.

Aan de slag

Aan de slag met de multimediaconsole is een proces in twee gedeelten. Eerst is er de webportal die u gebruikt om een configuratie te genereren en te publiceren voor de multimediaconsolesessie die u in uw omgeving maakt. Ten tweede is de plaatsing van de werkelijke multimediaconsole-app in uw omgeving en het instellen van de configuratiecode die moet worden gebruikt.

De multimediaconsole configureren met de webportal

Eerst moet u ervoor zorgen dat uw inhoud online wordt gehost, omdat u een URL nodig hebt. (U kunt foto's uploaden naar altvr.com, een video of .mp4 online hosten of een Dlive-livestreamkoppeling gebruiken: https://dlive.tv/yourlivestream)
Navigeer naar de webportal voor de multimediaconsole op https://multimedia-console.altvr.com/
Vanuit de webportal kunt u een configuratie genereren en publiceren voor de multimediaconsole. (Zie hieronder voor meer informatie over de verschillende eigenschappen).
Nadat u de media in de medialijst hebt ingevoerd en de algemene instellingen hebt geconfigureerd, selecteert u de knop Publiceren in het rechterbovengedeelte van de app.
Zodra het publiceren is voltooid, verschijnt er een dialoogvenster met een code van twee woorden die u kunt invoeren in de multimediaconsole die u hebt geplaatst.

De multimediaconsole in uw omgeving plaatsen

Selecteer in wereldeditor > deelvenster Editor > SDK Apps > Multimedia Console. (Ga niet naar World Editor > Basics > SDK App--that's for unregistered apps.)
Plaats de multimediaconsole zo dat deze het beste bij uw ruimte en publiek past.
Ga uit de bewerkingsmodus door op de oranje knop Bewerkingsmodus te klikken.
U wordt gevraagd bent u de eigenaar van de mediaspeler? Als u de officiële eigenaar van deze multimediaconsolesessie moet zijn, bevestigt u dit en gaat u verder. (Andere machtigingen zijn ook beschikbaar. Zie hieronder voor een gedetailleerde lijst.)
Selecteer Ja om te bevestigen dat u de primaire host bent.
Er wordt een dialoogvenster weergegeven waarin u wordt gevraagd een code in te voeren vanuit de webportal of een geldige JSON. Voer de code van twee woorden uit de webportal in, inclusief het streepje en druk op OK. (JSON is een geavanceerde configuratie die hieronder wordt beschreven)
De multimediaconsole moet na een paar seconden worden geladen met de configuratie die u in de webportal hebt gemaakt.

De multimediaconsole beheren

Nadat u de code hebt ingevoerd en het configuratieproces hebt voltooid, ziet u dat er besturingselementknoppen worden weergegeven onder een mediascherm.
- Afspelen start de mediaviewer (of wordt opnieuw opgestart bij de huidige vermelding, indien eerder gestopt)
- Stop de mediaviewer en verbergt de huidige media. 
- Volgende/prev slaat over naar volgende of vorige media
- x/x   toont de huidige index in de medialijst en stelt u in staat om naar elk punt in de lijst te gaan
- Met configuratie kunt u een nieuwe code opnieuw invoeren vanuit de webportal om een nieuwe configuratie in te stellen in de -console.

Nu bent u klaar om te beginnen met delen via de multimediaconsole.

Werken met de webportal

De webportal is een web-app waarmee u de verschillende functies van de multimediaconsole kunt configureren. Deze functies kunnen worden onderverdeeld in twee categorieën: algemene mediaconsole-instellingen en de lijst met media afspelen.

Algemene instellingen van de multimediaconsole

Afspelen Instellingen

Algemene instellingen voor afspelen voor de medialijst

Lijst met lusmedia: bepaalt of de medialijst moet worden omslussen zodra u het einde van de lijst bereikt.
Methode Start: selecteert de methode waarmee de multimediaconsole moet worden starten.
- Handmatig: wacht tot de knop Afspelen is ingedrukt voordat de media worden start
- Automatisch starten vanaf het begin: de medialijst automatisch starten vanaf het begin van de lijst
- Automatisch willekeurig starten: de media worden automatisch gestart vanaf een willekeurig startpunt in de lijst

Rollen

Roltoewijzingen voor het beheren en configureren van de multimediaconsole. Deze rollen worden onderverdeeld in de volgende set:

Alleen eigenaar: de gebruiker die de eigenaar is van de multimediaconsolesessie
Verhoogde gebruikers: gebruikers met moderator- of hostrollen in de ruimte waarin de multimediaconsole oorspronkelijk is geconfigureerd
Alle gebruikers - Alle gebruikers

Deze rollen stapelen in de zin dat aan alle rollen boven de rol die in deze lijst is gekozen, ook toestemming wordt verleend om die functie te gebruiken. Voorbeeld: Gebruikers met verhoogde toegang hebben de eigenaar, zelfs als ze geen moderator of host** zijn in AltspaceVR. Functies die worden beheerd door roltoewijzingen zijn als volgt

Kan mediaspeler bepalen: bepaalt welke rollen de knoppen voor het afspelen van media voor de multimediaconsole kunnen regelen
Kan de mediaspeler configureren: bepaalt welke rollen de multimediaconsole kunnen configureren door toegang te krijgen tot de knop Config

Foto's en video's toevoegen aan de medialijst

Media is het hart van de multimediaconsole. Afbeeldingen en videokoppelingen worden ondersteund als mediatypen in de multimediaconsole. Als u nieuwe media wilt toevoegen, selecteert u de pictogrammen Afbeelding toevoegen of Video toevoegen om een dialoogvenster weer te geven waarin u de mediagegevens en -instellingen kunt invoeren. Hieronder vindt u de uitsplitsing van de mediatypen en de bijbehorende instellingen

Afbeelding

Afbeeldingen moeten een standaardafbeeldingstype zijn, zoals jpeg, png en zoon. Ze moeten ergens worden gehost met een openbare koppeling.

Naam: (vereist) Naam die u wilt gebruiken om de afbeelding mee te identificeren.
Afbeeldings-URL : (vereist) De openbare URL van de afbeelding
Overslaan na: het aantal seconden waarna de afbeelding moet worden overgeslagen

Video

Video's kunnen worden gehoste video's of livestreams via Streams en DLive. (Andere ondersteuning werkt mogelijk met extra werk om de juiste stream-URL op te halen, maar wordt niet volledig ondersteund in de multimediaconsole)

Naam: (vereist) Naam die u wilt gebruiken om de video mee te identificeren.
Video-URL: (vereist) De openbare URL waarin de video wordt gehost of van waar de livestream wordt weergegeven.
Overslaan na: het aantal seconden waarna de video moet worden overgeslagen

Notitie

VEREIST: plaats de tijd die overeenkomt met de lengte van de video, zodat video's goed kunnen worden doorgestuurd. Als uw video bijvoorbeeld 5 minuten lang is, moet u 300 seconden lang zijn, anders wordt uw video niet overgeslagen naar het volgende deel van de inhoud.

Volume: het volume van de video van 0 (min.) - 1 (max.) waarden.
Begintijd: het aantal seconden vanaf het begin van de video.
Startafstand uitrollen: de afstand in meters in de wereld waar het volume begint af te vallen wanneer u de multimediaconsole daalt
Actie einde van video: de actie die moet worden ondernomen zodra het einde van de video is bereikt.
- Stoppen: de medialijst stopt nadat de video is beëindigd
- Lus: de video loopt door totdat deze handmatig wordt overgeslagen
- Volgende afspelen: de volgende media in de medialijst worden gestart nadat de huidige video is beëindigd.

Rechtstreeks met JSON werken (geavanceerd/optioneel)

De multimediaconsole ondersteunt het rechtstreeks invoeren van JSON in de prompt van de console in AltspaceVR. JSON is het interne mechanisme waarmee we mediaspelerconfiguraties inschakelen. Het beschikbaar maken van de mogelijkheid om JSON rechtstreeks in te stellen is iets waarmee meer geavanceerde gebruikers hun eigen werkstromen kunnen bouwen die voldoen aan hun behoeften en vertrouwd zijn met JSON. Hier volgt een korte beschrijving van de JSON-structuur en het schema waarmee de JSON wordt gevalideerd. Zie de bovenstaande secties over het configureren van de multimediaconsole voor meer gedetailleerde beschrijvingen van de onderstaande eigenschappen. Deze sectie is voornamelijk gericht op de schemavoorbeelden en structurering voor de JSON-gegevens.

Algemene media-instellingen

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

Medialijst

De medialijst is een eigenschap die is ingesteld in de hoofdmap van de JSON-structuur, zoals de rollen en het Instellingen. Het is een eenvoudige matrix die een van de volgende mediaconfiguratiestructuren kan bevatten. (Zie beschrijvingen van eigenschappen hierboven voor meer informatie over wat elk doet.)

Voorbeeld van afbeelding

Vereiste velden: 'name' en 'imageUrl'

{
    "name": "Altspace Screenshot",
    "imageUrl": "https://pbs.twimg.com/media/CxJ-fJqUsAAFtd9.jpg",
    "skipAfter": 10
}

Videovoorbeeld

Vereiste velden: 'name' en 'videoUrl'

{
    "name": "Ninja Twitch Live Stream",
    "videoUrl":"https://www.twitch.tv/ninja",
    "volume":0.2,
    "startTime":0,
    "endOfVideoAction":"play-next"
}

Voorbeeld van JSON

{
  "loopMediaList": false,
  "startMethod": "autostart-beginning",
  "controlMediaPlayer": "everyone",
  "configureMediaPlayer": "elevated",
  "mediaList": [
    {
      "videoUrl": "https://www.twitch.tv/ninja",
      "volume": 0.2,
      "startTime": 0,
      "endOfVideoAction": "play-next"
    },
    {
      "imageUrl": "http://www.hypergridbusiness.com/wp-content/uploads/2016/09/AltspaceVR-highrise.jpg",
      "skipAfter": 10
    },
    {
      "imageUrl": "https://d1qb2nb5cznatu.cloudfront.net/startups/i/333629-6ffd7199b9bcf34d8957e8e09d974a38-medium_jpg.jpg?buster=1423092095",
      "skipAfter": 5
    },
    {
      "imageUrl": "https://pbs.twimg.com/media/CxJ-fJqUsAAFtd9.jpg",
      "skipAfter": 10
    },
    {
      "imageUrl": "https://altvr-wpengine.netdna-ssl.com/wp-content/uploads/2019/05/Educators-in-VR-Social-VR-AltspaceVR.png",
      "skipAfter": 10
    },
    {
      "videoUrl": "https://www.twitch.tv/shroud",
      "volume": 1,
      "startTime": 0,
      "endOfVideoAction": "stop"
    }
  ]
}

Schema

{
  "$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"
            ]
          }
        ]
      }
    }
  }
}