Interpretation of the name
What is Work
Work isis a description of a three-dimensional space provided by the Developer Center. It is the data scanned and processed by Realsee hardware devices (Realsee Scanner ,Realsee Lite Panoramic Camera ,Realsee VR App ) for three-dimensional space display.
Work uses JSON
as the data format Five framework can parse and display Work data.An Five instance can be loaded and shown a Work.It can also be dynamically switched between Work.
Use restrictions on work
You need to configure your security domain name and Work data available timeinRealsee Developer Center. Use Five to verify this in production environments to protect developers and see data security.
The above restrictions will not be verified in the following cases, which is convenient for development and testing:
- Domain named
localhost
. - Domain named ip address, e.g.
127.0.0.1
,192.168.0.5
,172.30.2.0
,10.33.10.2
etc. - Access in non-HTTP settings, e.g. file:// protocol.
Please do not modify it manually work
data, otherwise it will cause unpredictable rendering problems!
Work data samples are as follows:
Click to view work data examples
{
"initial": {
"mode": "Panorama",
"pano_index": 6,
"longitude": 2.6869287662553916,
"latitude": 0,
"fov": 95
},
"model": {
"file_url": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/model/auto3d-DJaa08PIzN4JYluXQ1j2VS.at3d",
"material_textures": [
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_0.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_1.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_2.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_3.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_4.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_5.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_6.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_7.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_8.jpg",
"https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/materials/texture_9.jpg"
]
},
"panorama": {
"list": [
{
"up": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/0/2257f0f0b29d5b00ff01934ce51aaa35/0_u.jpg",
"down": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/0/2257f0f0b29d5b00ff01934ce51aaa35/0_d.jpg",
"left": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/0/2257f0f0b29d5b00ff01934ce51aaa35/0_l.jpg",
"right": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/0/2257f0f0b29d5b00ff01934ce51aaa35/0_r.jpg",
"front": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/0/2257f0f0b29d5b00ff01934ce51aaa35/0_f.jpg",
"back": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/0/2257f0f0b29d5b00ff01934ce51aaa35/0_b.jpg"
},
{
"up": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/1/ecb554bb1c122fa90186d176ccfecde4/1_u.jpg",
"down": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/1/ecb554bb1c122fa90186d176ccfecde4/1_d.jpg",
"left": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/1/ecb554bb1c122fa90186d176ccfecde4/1_l.jpg",
"right": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/1/ecb554bb1c122fa90186d176ccfecde4/1_r.jpg",
"front": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/1/ecb554bb1c122fa90186d176ccfecde4/1_f.jpg",
"back": "https://vrlab-public.ljcdn.com/release/auto3dhd/a62e1ebf7d013f7df117551a14af79fc/images/cube_2048/1/ecb554bb1c122fa90186d176ccfecde4/1_b.jpg"
}
]
},
"observers": [
{
"visible_nodes": [1],
"accessible_nodes": [1],
"quaternion": {
"w": 0.45076583925142194,
"x": 0.010070951976936936,
"y": -0.8925839597148215,
"z": -0.0016154299986102319
},
"standing_position": [
-6.956049919128418, -1.3924440682333898, 1.6591600179672241
],
"position": [
-6.956049919128418, -0.10312400013208389, 1.6591600179672241
],
"floor_index": 0
},
{
"visible_nodes": [0],
"accessible_nodes": [0],
"index": 1,
"quaternion": {
"w": -0.9884643083591809,
"x": -0.0038900979633806664,
"y": 0.1512670435365699,
"z": -0.006439990839033269
},
"standing_position": [
-6.176340103149414, -1.380554749576384, 2.179759979248047
],
"position": [-6.176340103149414, -0.10025200247764587, 2.179759979248047],
"floor_index": 0
}
]
}
Data description for work
initial
: initialize data, aState
data.Description of Work the position of the initial state, also known as the initial view of VR- mode: models
- pano_index: initialize point
- longitude: Horizontal corner of camera
- latitude: alpha corner of the camera
- fov: Visible angle in the vertical direction of the camera
model
: three-dimensional model- file_url: resource address of the three-dimensional model, file
.at3d
for model format as deemed customized - material_textures: a map resource address for 3D models
- file_url: resource address of the three-dimensional model, file
panorama
: panorama color information- list:
- up / down / left / right / front / back: Global color information is stored and used in cubemap.
- list:
observers
: Gathering point information- visible_nodes: List of visibility between collection points
- access_nodes: list of connections between collection points
- quaternon: rotation offset between collection points and model coordinates
- standing_position: Ground Coordinates of Gathering Points
- position: collection point coordinates
- floor_index: Gather Point Layer
What is Five State
State is Five The data structure for describing the state.He contains modelling, where the collection point is located, the direction of the camera, and the view of the camera. You can use State to operate Five or get Five current status.
interface State {
mode: Five.Mode;
panoIndex: number;
longitude: number;
latitude: number;
fov: number;
}
Data description for State
mode
: Current mode common to 5 models that can be obtained usingFive.Mode
- Panorama: Panoramic walk modeIn this mode, the view will walk among the collection points. Gesture operations can rotate/enlarge the viewing angle/switch collection points, which is suitable for viewing the collected panoramic information.
- Floorplan: General Space Overview Mode, views in this mode are model-centric, gesture can rotte/zoom models/switch floors suitable for viewing the overall effects of the model.
- Topview: Household Graph TemplateThe view is centered on the model, vertical overhead view models. Gesture operations can shift/zoom in the floor/toggle the floor of the building, suitable for viewing model plane structure.
- Model: model walk mode, in this mode the view will walk freely in the model, and the gesture operation can rotate/magnify the viewing angle/displacement, which is suitable for viewing the details of the model and doing some positioning operations.
- VRPanorama: VR glasses modelthat can be displayed using Cardboard glasses or his third-party derivative to implement VR virtual display.
panoIndex
: Gathering point positionlongitude
/latitude
: Horizontal corner of the camera/camera (radians), we describe the position of the camera in a latitude similar way.fov
: Visual angle in the vertical direction of the camera (angle)