https://github.com/codeanticode/hubs-connect

A Processing library for programmatic access to Mozilla Hubs
https://github.com/codeanticode/hubs-connect

library mozilla-hubs processing

Last synced: 24 days ago
JSON representation

A Processing library for programmatic access to Mozilla Hubs

• Host: GitHub
• URL: https://github.com/codeanticode/hubs-connect
• Owner: codeanticode
• License: other
• Created: 2022-04-25T12:54:03.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-06-14T11:19:50.000Z (over 2 years ago)
• Last Synced: 2023-04-14T04:21:36.388Z (over 1 year ago)
• Topics: library, mozilla-hubs, processing
• Language: Java
• Homepage:
• Size: 7.32 MB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: license.txt

Awesome Lists containing this project

README

        
## Hubs Connect

This is a library for the [Processing programming environment](https://processing.org/) that allows accessing a [Mozilla Hubs](https://hubs.mozilla.com/) room programatically. It is based on the [HubsCloudUtil](https://github.com/rawnsley/HubsCloudUtil) library by [Rupert Rawnsley](https://github.com/rawnsley).

# Installing and using

You have to install the library manually by downloading the latest release and upacking the zip file in Processing's contributed libraries folder. The library comes with a few examples, the basic use is with the example below:

```

import codeanticode.hubs.*;

HubsConnect hubs;

boolean connected = false;

String objectId = "";

void setup() {

  size(400, 400);

  

  hubs = new HubsConnect(this);

  

  PFont font = createFont("Arial", 40);

  textFont(font);

}

void draw() {

  background(0);

  fill(255);

  text("Connected: " + connected + "\nmouseX: " + mouseX + "\nmouseY: " + mouseY, 40, 100);

  if (connected && objectId != "") {

    hubs.moveObject(objectId, map(mouseX, 0, width, -2, +2), 0, map(mouseY, 0, height, -2, +2));

  }

}

void keyPressed() {

  if (key == ' ') {

    if (!connected) {

      // In order to connect to an existing Hubs room, you need the room ID, which you can get from the URL:

      // https://hubs.mozilla.com/

      // and the authenticationt token, which is included in the "Your Hubs Sign-In Link" email from Hubs. This email contains a line like this:

      // https://hubs.mozilla.com/?auth_origin=spoke&auth_payload=<...>&auth_token=&auth_topic=<...>

      connected = hubs.open("processing-coder", "", "");

      hubs.enter(0, 0, -2);

    } else {

      hubs.close();

      connected = false;

      objectId = "";

    }

  }

}

void mousePressed() {

  if (connected && objectId == "") {

    // Use the URL of a 3-D model from sketchfab, for example:

    objectId = hubs.createObject("https://sketchfab.com/models/6511da7be4714b7a896f25ee51bf54e8", map(mouseX, 0, width, -2, +2), 0, map(mouseY, 0, height, -2, +2));

  }

}

```

You have to provide the ID of a room to open with the library, and then you can enter it with a "puppet" avatar that's controlled from the code, as well as creating and moving objects around. 

**Please note** that this library is currently at the alpha/prototype stage. It should be considered a proof of concept at this point.