stingray.GoogleVR 네임스페이스 참조

설명

이 오브젝트는 Google VR 인터페이스에 대한 액세스를 제공합니다.

기타 관련 참조 항목

Plug-ins

함수

compute_distorted_point ( eye, point ) : stingray.Vector2+ 가능한 경우, 특정 눈의 특정 점에 대한 왜곡 점을 계산합니다.

매개변수

eye :	integer	쿼리할 눈(stingray.GoogleVR.LEFT_EYE 또는 stingray.GoogleVR.RIGHT_EYE)입니다.
point :	stingray.Vector2	눈의 뷰포트 왼쪽 하단 모서리에서 (0, 0), 눈의 뷰포트 오른쪽 상단 모서리에서 (1, 1)인 상태에서 [0,1]^2의 화면 눈 Viewport Space에 있는 점입니다.

반환하는 항목

stingray.Vector2+

빨간색, 초록색, 파란색 왜곡 점을 포함한 세 가지 Vector2를 반환합니다. + 표기는 지정된 유형의 인스턴스가 1개 이상 있을 수 있음을 나타냅니다.

왜곡은 눈의 렌즈로 인해 발생하는 광학 왜곡을 반전시킵니다. 색수차 때문에 왜곡은 각 색상 채널마다 다릅니다.

controller_acceleration ( ) : stingray.Vector3 현재 제어기에 대해 이 프레임의 가속 방향을 제곱초당 미터(m/s^2)로 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Vector3

제어기의 가속 방향(제곱초당 미터)

controller_api_status ( ) : integer 제어기의 API 상태를 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

integer

제어기의 API 상태 [GoogleVR.STATUS_API_OK, GoogleVR.STATUS_API_UNSUPPORTED, GoogleVR.STATUS_API_NOT_AUTHORIZED, GoogleVR.STATUS_API_UNAVAILABLE, GoogleVR.STATUS_API_SERVICE_OBSOLETE, GoogleVR.STATUS_API_CLIENT_OBSOLETE, GoogleVR.STATUS_API_MALFUNCTION]

controller_api_status_string ( status ) : string 제어기의 API 상태를 문자열로 반환합니다.

매개변수

status :

integer

제어기 API 상태 [GoogleVR.STATUS_API_OK, GoogleVR.STATUS_API_UNSUPPORTED, GoogleVR.STATUS_API_NOT_AUTHORIZED, GoogleVR.STATUS_API_UNAVAILABLE, GoogleVR.STATUS_API_SERVICE_OBSOLETE, GoogleVR.STATUS_API_CLIENT_OBSOLETE, GoogleVR.STATUS_API_MALFUNCTION]

반환하는 항목

string

제어기의 API 상태(문자열)

controller_connection_status ( ) : integer 제어기의 연결 상태를 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

integer

제어기의 연결 상태 [GoogleVR.STATUS_DISCONNECTED, GoogleVR.STATUS_SCANNING, GoogleVR.STATUS_CONNECTING, GoogleVR.STATUS_CONNECTED]

controller_connection_status_string ( status ) : string 제어기의 연결 상태를 문자열로 반환합니다.

매개변수

status :

integer

제어기 연결 상태 [GoogleVR.STATUS_DISCONNECTED, GoogleVR.STATUS_SCANNING, GoogleVR.STATUS_CONNECTING, GoogleVR.STATUS_CONNECTED]

반환하는 항목

string

제어기의 연결 상태(문자열)

controller_gyroscope ( ) : stingray.Vector3 현재 제어기의 각도 속도를 라디안으로 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Vector3

제어기의 각도 속도(라디안)

controller_held ( button ) : boolean 지정된 버튼이 현재 유지되는지를 나타냅니다.

매개변수

button :

integer

제어기 버튼 [GoogleVR.BUTTON_CLICK, GoogleVR.BUTTON_HOME, GoogleVR.BUTTON_APP, GoogleVR.BUTTON_VOLUME_UP, GoogleVR.BUTTON_VOLUME_DOWN]

반환하는 항목

boolean

지정된 버튼이 제어기에서 유지된 상태이면 true이며 그렇지 않으면 false입니다.

controller_orientation ( ) : stingray.Quaternion 현재 제어기 방향을 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Quaternion

제어기의 방향

controller_pressed ( button ) : boolean 지정된 버튼이 이 프레임에서 눌러진 상태인지를 나타냅니다.

매개변수

button :

integer

제어기 버튼 [GoogleVR.BUTTON_CLICK, GoogleVR.BUTTON_HOME, GoogleVR.BUTTON_APP, GoogleVR.BUTTON_VOLUME_UP, GoogleVR.BUTTON_VOLUME_DOWN]

반환하는 항목

boolean

지정된 버튼이 제어기에서 눌러진 상태이면 true이며 그렇지 않으면 false입니다.

이 값은 "임시적인" 결과이며 값이 true인 경우 이벤트 후에 한 프레임에 대해서만 true이고 후속 프레임의 호출에 대해서는 false입니다.

controller_released ( button ) : boolean 지정된 버튼이 지정된 제어기의 프레임에서 눌렀다 놓은 상태인지를 나타냅니다.

매개변수

button :

integer

제어기 버튼 [GoogleVR.BUTTON_CLICK, GoogleVR.BUTTON_HOME, GoogleVR.BUTTON_APP, GoogleVR.BUTTON_VOLUME_UP, GoogleVR.BUTTON_VOLUME_DOWN]

반환하는 항목

boolean

지정된 버튼이 제어기에서 눌렀다 놓은 상태이면 true이며 그렇지 않으면 false입니다.

이 값은 "임시적인" 결과이며 값이 true인 경우 이벤트 후에 한 프레임에 대해서만 true이고 후속 프레임의 호출에 대해서는 false입니다.

controller_touch ( ) : boolean 터치패드가 현재 제어기의 이 프레임에서 터치된 상태인지 여부에 따라 true 또는 false를 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

boolean

터치패드가 제어기에서 터치된 상태이면 true이고, 그렇지 않으면 false

controller_touched ( ) : boolean 터치패드에서 이 프레임을 터치하는 것을 시작한 상태인지를 나타냅니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

boolean

사용자가 터치패드에서 터치를 시작한 상태이면 true이며 그렇지 않으면 false입니다.

이 값은 "임시적인" 결과이며 값이 true인 경우 이벤트 후에 한 프레임에 대해서만 true이고 후속 프레임의 호출에 대해서는 false입니다.

controller_touch_position ( ) : stingray.Vector2 현재 제어기에 대해 터치패드가 터치되었는지에 따라 현재 또는 마지막 터치 위치를 정규화된 좌표(0,0 왼쪽 위, 1,1 오른쪽 아래)로 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Vector2

제어기 터치패드의 터치 위치(정규화된 좌표)

controller_untouched ( ) : boolean 터치패드에서 이 프레임을 터치하는 것을 중지한 상태인지를 나타냅니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

boolean

사용자가 터치패드에서 터치를 중지한 상태이면 true이며 그렇지 않으면 false입니다.

이 값은 "임시적인" 결과이며 값이 true인 경우 이벤트 후에 한 프레임에 대해서만 true이고 후속 프레임의 호출에 대해서는 false입니다.

controller_value ( controller, button ) : number, number 지정된 제어기 버튼의 아날로그 값을 반환합니다.

매개변수

controller :	integer	제어기 색인(GoogleVR에 사용되지 않음, 0으로 설정됨)
button :	integer	제어기 버튼 [GoogleVR.BUTTON_CLICK, GoogleVR.BUTTON_HOME, GoogleVR.BUTTON_APP, GoogleVR.BUTTON_VOLUME_UP, GoogleVR.BUTTON_VOLUME_DOWN]

반환하는 항목

number	지정된 제어기 버튼의 첫 번째 아날로그 값입니다. 사용되지 않는 경우 0.0이 반환됩니다.
number	지정된 제어기 버튼의 두 번째 아날로그 값입니다. 사용되지 않는 경우 0.0이 반환됩니다.

GoogleVR.BUTTON_CLICK이 요청되면 터치패드의 x 및 y 아날로그 위치가 반환됩니다. 그렇지 않은 경우 다른 모든 버튼의 첫 번째 값에는 아날로그 값(0~1 사이에서 변함)이 포함되고 두 번째 값은 항상 0입니다.

eye_fov ( eye ) : table 지정된 눈의 뷰 필드를 포함하고 있는 테이블을 반환합니다.

매개변수

eye :

integer

쿼리할 눈(stingray.GoogleVR.LEFT_EYE 또는 stingray.GoogleVR.RIGHT_EYE)입니다.

반환하는 항목

table

눈 뷰 필드로 채워진 테이블입니다.

hide_ui_overlay ( ) 디바이더 막대, 설정 버튼 및 뒤로 버튼이 포함된 GoogleVR UI 오버레이를 숨깁니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

hmd_info ( ) : table HMD 정보를 포함하고 있는 테이블을 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

table

GoogleVR HMD 정보로 채워진 테이블입니다.

"type" 필드는 뷰어 유형을 "Cardboard", "Daydream" 또는 "알 수 없음"으로 식별합니다.

hmd_local_pose ( ) : stingray.Matrix4x4, stingray.Matrix4x4, stingray.Matrix4x4 HMD의 머리, 왼쪽 눈 및 오른쪽 눈 로컬 포즈를 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Matrix4x4	머리 로컬 포즈입니다.
stingray.Matrix4x4	왼쪽 눈 로컬 포즈입니다.
stingray.Matrix4x4	오른쪽 눈 로컬 포즈입니다.

hmd_world_pose ( ) : stingray.Matrix4x4, stingray.Matrix4x4, stingray.Matrix4x4 HMD의 머리, 왼쪽 눈 및 오른쪽 눈 표준 포즈를 반환합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

stingray.Matrix4x4	머리 표준 포즈입니다.
stingray.Matrix4x4	왼쪽 눈 표준 포즈입니다.
stingray.Matrix4x4	오른쪽 눈 표준 포즈입니다.

추적되지 않는 경우 ID 매트릭스가 반환됩니다.

initialize ( ) : boolean Google VR 시스템을 초기화합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

boolean

Google VR이 올바로 초기화되었으면 true를, 그렇지 않으면 false를 반환합니다.

launch_or_install_settings_app ( ) Google VR 설정 앱을 시작하거나 설치합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

link_node_to_eye ( unit, node, eye, world ) VR 추적기에 의해 자동으로 업데이트되어야 하는 유닛 노드를 링크합니다.

매개변수

unit :	stingray.Unit	눈에 링크할 유닛입니다.
node :	integer	유닛 내에 링크된 장면 그래프 노드입니다.
eye :	integer	링크할 눈(stingray.GoogleVR.LEFT_EYE 또는 stingray.GoogleVR.RIGHT_EYE)입니다.
world :	stingray.World	유닛을 포함하고 있는 표준입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

recenter ( ) 머리 방향의 중심을 재설정합니다(피치 및 롤은 수정하지 않은 채로 요를 0으로 재설정).

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

Daydream 장치에는 아무 작업도 하지 않습니다(중심 재설정은 자동으로 처리됨).

refresh_viewer_profile ( ) 장치에 저장되어 있는 뷰어 프로필로 Google VR을 새로 고칩니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

setup_render_targets ( left_eye_rt, right_eye_rt ) Google VR 렌더 대상을 설정합니다.

매개변수

left_eye_rt :	string	왼쪽 눈 렌더 대상 이름입니다.
right_eye_rt :	string	오른쪽 눈 렌더 대상 이름입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_default_viewer_profile ( uri ) URI로 지정된 기본 뷰어 프로필을 설정합니다.

매개변수

uri :

string

앱이 사용해야 하는 뷰어 프로필을 나타내는 짧은 URI 또는 표준 URI를 포함하고 있는 문자열입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

set_tracking_space_pose ( pose ) 제공된 포즈를 기본 추적 공간 포즈로 설정합니다.

매개변수

pose :

stingray.Matrix4x4

추적 공간 포즈입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

show_ui_overlay ( ) 디바이더 막대, 설정 버튼 및 뒤로 버튼이 포함된 GoogleVR UI 오버레이를 표시합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

shutdown ( ) Google VR 시스템을 종료합니다.

매개변수

이 함수는 어떠한 매개변수도 수용하지 않습니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

unlink_eye ( eye ) VR 추적기에 의해 자동으로 업데이트되는 모든 유닛 노드를 링크 해제합니다.

매개변수

eye :

integer

링크 해제할 눈(stingray.GoogleVR.LEFT_EYE 또는 stingray.GoogleVR.RIGHT_EYE)입니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.