Skip to main content

sceneViewer

Typeboolean | SceneViewerSessionOptions
Defaulttrue

Options for the Google SceneViewer based AR session.
If false is given, it will disable SceneViewer based AR session.

See Official Page for the parameter details.

NameTypeDefaultDescription
filestring | nullnullThis URL specifies the glTF or glb file that should be loaded into Scene Viewer. This should be URL-escaped. If null is given, it will try to use current model shown on the canvas.
fallbackURLstring | nullnullThis is a Google Chrome feature supported only for web-based implementations. When the Google app com.google.android.googlequicksearchbox is not present on the device, this is the URL that Google Chrome navigates to.
modestring"ar_only"See SCENE_VIEWER_MODE for available modes (also check their official page for details).
titlestring | nullnullA name for the model. If present, it will be displayed in the UI. The name will be truncated with ellipses after 60 characters.
linkstring | nullnullA URL for an external webpage. If present, a button will be surfaced in the UI that intents to this URL when clicked.
soundstring | nullnullA URL to a looping audio track that is synchronized with the first animation embedded in a glTF file. It should be provided alongside a glTF with an animation of matching length. If present, the sound is looped after the model is loaded. This should be URL-escaped.
resizablebooleantrueWhen set to false, users will not be able to scale the model in the AR experience. Scaling works normally in the 3D experience.
verticalbooleanfalseWhen set to true, users will be able to place the model on a vertical surface.
disableOcclusionbooleanfalseWhen set to true, SceneViewer will disable {@link https://developers.google.com/ar/develop/java/depth/introduction object blending}
initialScalestring | null"auto"Initial scale of the 3D model. If set to null, 3D model will shown as its original size and will disable the "View actual size" button. Default value is "auto", and "1" will show model size in 100%, "2" in 200%, "0.5" in 50% and so on.
shareTextstring | nullnullA text that will be displayed when user clicked the share button.

Example

sceneViewer: true (default)

{
src: "/egjs-view3d/model/draco/alarm.glb",
iosSrc: "/egjs-view3d/model/usdz/alarm.usdz",
sceneViewer: true,
webAR: false
}

Detailed Options

{
src: "/egjs-view3d/model/draco/alarm.glb",
iosSrc: "/egjs-view3d/model/usdz/alarm.usdz",
sceneViewer: {
title: "CUSTOM TITLE",
link: "https://github.com/naver/egjs-view3d",
resizable: true,
vertical: true,
disableOcclusion: true,
initialScale: "2",
shareText: "CUSTOM SHARE TEXT"
},
webAR: false
}