0.3.13 • Published 2 years ago

echo3d v0.3.13

Weekly downloads
-
License
-
Repository
-
Last release
2 years ago

echo3D React Components

This package contains helpful React components designed to work with the echo3D platform API.

Using the package

  1. Install via npm i echo3d:

  2. Importing <model-viewer/>:

If your framework does not utilize server side rendering: run npm i @google/model-viewer and add import '@google/model-viewer' to any files that utilize <Echo/>

If your framework does utilize server side rendering: Issues arise when components or pages importing model-viewer are rendered server side. To most reliably resolve this issue for SSR apps, provide the model-viewer via a script element in your _document file eg: <script type="module" src="https://unpkg.com/@google/model-viewer/dist/model-viewer.min.js"></script>

  1. (Only for typescript apps) If you do not have a globals.d.ts file, create one within your app src folder, add the line declare module 'echo3d'; and save the file to resolve compiler typing errors.

<Echo/> Model Viewer Component

This very young package currently contains only one component, a 3D model viewer built using google model-viewer. This component can be configured with an apiKey and entryID to stream and display models from the echo3D platform as well as a direct src url to display local or cloud files. Common <model-viewer/> configuration parameters are also exposed.

Required Parameters

You must provide src or both apiKey and entryID.

src: Element will make no query and pass this url directly to

apiKey: Your echo3D project apiKey, eg some-words-1234

entryID: The entry ID of the hologram you would like to display

Optional Parameters

className: The CSS classes that will be applied to the element. If no classes are provided, the component will default to a 600px height viewer.

securityKey: provide your security key if it is enabled for your project

disableZoom: When defined, disables zoom (camera controls must be enabled)

cameraOrbit: The starting focal point of the viewer

cameraControls: When defined, camera controls for the viewer are disabled

autoRotate: When defined, automatic rotation of the model is disabled

tapToCenter: When defined, tap-to-recenter behavior is enabled

Issues?

Please email support@echo3d.co if you experience any issues using this package.

0.3.13

2 years ago

0.3.12

2 years ago

0.3.11

3 years ago

0.3.10

3 years ago

0.3.9

3 years ago

0.3.8

3 years ago

0.3.7

3 years ago

0.3.6

3 years ago

0.3.5

3 years ago

0.3.4

3 years ago

0.3.3

3 years ago

0.3.2

3 years ago

0.3.1

3 years ago

0.3.0

3 years ago

0.2.10

3 years ago

0.2.9

3 years ago

0.2.8

3 years ago

0.2.7

3 years ago

0.2.6

3 years ago

0.2.5

3 years ago

0.2.4

3 years ago

0.2.3

3 years ago

0.2.2

3 years ago

0.2.1

3 years ago

0.2.0

3 years ago

0.1.21

3 years ago

0.1.20

3 years ago

0.1.18

3 years ago

0.1.17

3 years ago

0.1.16

3 years ago

0.1.15

3 years ago

0.1.14

3 years ago

0.1.13

3 years ago

0.1.12

3 years ago

0.1.11

3 years ago

0.1.10

3 years ago

0.1.9

3 years ago

0.1.8

3 years ago

0.1.7

3 years ago

0.1.6

3 years ago

0.1.5

3 years ago

0.1.4

3 years ago

0.1.3

3 years ago

0.1.2

3 years ago

0.1.1

3 years ago

0.1.0

3 years ago