VRService

Lorsqu'il est défini à Enum.VRScaling.World, Camera.HeadScale ajuste de sorte que la taille du monde soit vue du point de vue de l'avatar.Un joueur avec un petit avatar percevra les objets autour de lui comme plus grands que ceux d'un joueur avec un grand avatar.

Lorsqu'il est réglé sur vrai, un joueur VR pourra animer ses mains et sa tête en utilisant ses contrôleurs et son casque.

Cette propriété doit être définie sur le serveur.

Lorsque c'est vrai, la vue d'un joueur VR disparaît en noir lorsque sa tête se heurte à un objet.Cette propriété empêche les joueurs de pouvoir voir à travers les murs en VR.La valeur par défaut est vraie.

Cette propriété décrit ce que Enum.UserCFrame est responsable de l'entrée dans VR.Par instance, si un casque VR est responsable, la valeur de cette propriété sera Enum.UserCFrame.Head .

Pour vérifier si Roblox détecte des appareils VR, qui seraient responsables de l'entrée en VR, vous pouvez vérifier la propriété VREnabled.

local VRService = game:GetService("VRService")

if VRService.VREnabled then
	print(VRService.GuiInputUserCFrame.Name)
else
	print("No VR device detected!")
end

Cette propriété décrit si l'utilisateur utilise un appareil de réalité virtuelle (VR).

Si un appareil VR est activé, vous pouvez interagir avec sa localisation et son mouvement via des méthodes telles que UserInputService:GetUserCFrame().Vous pouvez également réagir au mouvement du dispositif VR en utilisant l'événement UserInputService.UserCFrameChanged.

local UserInputService = game:GetService("UserInputService")

local isUsingVR = UserInputService.VREnabled
if isUsingVR then
	print("User is using a VR headset!")
else
	print("User is not using a VR headset!")
end

Cette propriété ne peut être utilisée qu'en LocalScript .

Voir aussi

• Camera.HeadLocked
• UserInputService:GetUserCFrame()
• UserInputService.UserCFrameChanged

local VRService = game:GetService("VRService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.CharacterAdded:Wait()
local head = character:WaitForChild("Head")

local function TrackHead(inputType, value)
	if inputType == Enum.UserCFrame.Head then
		head.CFrame = value
	end
end

if VRService.VREnabled then
	-- Set the initial CFrame
	head.CFrame = VRService:GetUserCFrame(Enum.UserCFrame.Head)

	-- Track VR headset movement and mirror for character's head
	VRService.UserCFrameChanged:Connect(TrackHead)
end

Cette méthode renvoie le Enum.VRTouchpadMode indiquant le mode d'un mode spécifié Enum.VRTouchpad .Le mode retourné indique comment l'utilisateur interagit avec son touchpad pour jouer au jeu.

Cela peut également être utilisé aux côtés des plusieurs méthodes et événements VR UserInputService.

Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un LocalScript.

Paramètres

Retours

local VRService = game:GetService("VRService")

VRService:GetTouchpadMode(Enum.VRTouchpad.Left)

Cette méthode renvoie un CFrame décrivant la position et l'orientation d'un appareil de réalité virtuelle spécifié comme un décalage par rapport à un point dans l'espace du monde réel.Cette méthode doit être utilisée lors de la mise en œuvre de la compatibilité VR dans un jeu pour obtenir et suivre le mouvement d'un appareil VR connecté.

En utilisant la méthode, les développeurs peuvent implémenter des fonctionnalités telles que le répositionnement du personnage de l'utilisateur dans le jeu correspondant à l'emplacement d'un appareil VR connecté.Cela peut être fait en modifiant le CFrame du personnage du joueur dans le jeu pour correspondre au CFrame de l'appareil VR spécifié en utilisant les arguments de valeur UserCFrame et CFrame transmis par l'événement.

VRService fournit également un événement UserCFrameChanged qui se déclenche automatiquement lorsque le CFrame du dispositif VR connecté change, tant qu'il est utilisé dans un LocalScript .

Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un LocalScript.

Paramètres

Retours

local Workspace = game:GetService("Workspace")
local VRService = game:GetService("VRService")

local camera = Workspace.CurrentCamera
local part = script.Parent.Part
local handOffset = VRService:GetUserCFrame(Enum.UserCFrame.LeftHand)

-- Account for headscale
handOffset = handOffset.Rotation + handOffset.Position * camera.HeadScale
part.CFrame = camera.CFrame * handOffset

Cette méthode renvoie true si le dispositif de réalité virtuelle spécifié Enum.UserCFrame est disponible pour être écouté.Il peut être utilisé pour déterminer si un appareil VR spécifié, tel que Enum.UserCFrame.Head, est connecté au jeu de l'utilisateur.

Cela peut également être utilisé aux côtés des plusieurs méthodes et événements VR UserInputService.

Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un LocalScript.

Paramètres

Retours

local VRService = game:GetService("VRService")

local isEnabled = VRService:GetUserCFrameEnabled(Enum.UserCFrame.Head)
if isEnabled then
	print("VR device is enabled!")
else
	print("VR device is disabled!")
end

Cette méthode redécentre le CFrame de la tête de l'utilisateur à l'emplacement actuel du casque VR porté par l'utilisateur.Il peut être utilisé pour assurer que la tête de l'utilisateur dans le jeu soit positionnée en fonction de l'emplacement du casque VR de l'utilisateur.

Cela se comporte de manière identique à UserInputService:RecenterUserHeadCFrame().

Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un LocalScript.

Retours

local VRService = game:GetService("VRService")

VRService:RecenterUserHeadCFrame()

Cette méthode demande la navigation vers le spécifié CFrame en utilisant le spécifié Enum.UserCFrame comme origine pour la parabole visuelle.Il peut être utilisé pour incorporer la réalité virtuelle (VR) dans votre jeu en fournissant un moyen de visualiser un chemin de navigation depuis l'appareil VR de l'utilisateur jusqu'à une destination.

VRService a un événement similaire, NavigationRequested, utilisé pour détecter de telles demandes.Cela peut également être utilisé aux côtés des plusieurs méthodes et événements VR UserInputService.

Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un LocalScript.

Paramètres

Retours

local VRService = game:GetService("VRService")

local destination = workspace:FindFirstChild("NavigationDestination")

VRService:RequestNavigation(Enum.UserCFrame.Head, destination.CFrame)

Cette méthode définit le mode du mode spécifié Enum.VRTouchpad à celui spécifié Enum.VRTouchpadMode.Il peut être utilisé pour modifier le mode de la tablette de réalité virtuelle (VR) de l'utilisateur afin que l'utilisateur interagisse différemment avec le jeu en utilisant la tablette.

Cela peut également être utilisé aux côtés des plusieurs méthodes et événements VR UserInputService.

Cette méthode ne fonctionnera que lorsqu'elle est utilisée dans un LocalScript.

Paramètres

Retours

local VRService = game:GetService("VRService")

VRService:SetTouchpadMode(Enum.VRTouchpad.Left, Enum.VRTouchpadMode.Touch)

Cet événement se déclenche lorsque la navigation est demandée à partir de VRService pour un appareil VR spécifié Enum.UserCFrame.Il tire avec une coordonnée CFrame et l'indication spécifiée Enum.UserCFrame indiquant la demande d'appareil demandant la navigation.

Cet événement peut être utilisé aux côtés des événements et des méthodes de service UserInputService.

Puisque cet événement se déclenche localement, il ne peut être utilisé qu'en LocalScript .

Paramètres

local VRService = game:GetService("VRService")

VRService.TouchpadModeChanged:Connect(function(cframe, inputUserCFrame)
	print(inputUserCFrame.Name .. " made request with CFrame: " .. cframe)
end)

Cet événement se déclenche si le Enum.VRTouchpadMode d'un Enum.VRTouchpad est modifié.Vous pouvez utiliser cet événement pour suivre les états des touches VR connectées via le client de l'utilisateur.

Cet événement peut être utilisé aux côtés des événements et des méthodes de service UserInputService.

Puisque cet événement se déclenche localement, il ne peut être utilisé qu'en LocalScript .

Paramètres

local VRService = game:GetService("VRService")

VRService.NavigationRequested:Connect(function(pad, mode)
	print(pad.Name .. " Touchpad changed to state: " .. mode.Name)
end)

Cet événement se déclenche lorsqu'un Enum.UserCFrame est modifié, par exemple lorsque l'utilisateur déplace un appareil VR connecté.Il peut être utilisé aux côtés de GetUserCFrame() pour suivre les coordonnées CFrame d'un appareil VR et lorsqu'il change/se déplace.Il peut également être utilisé aux côtés des événements et des méthodes de service UserInputService.

Puisque cet événement se déclenche localement, il ne peut être utilisé qu'en LocalScript .

Paramètres

local VRService = game:GetService("VRService")

VRService.UserCFrameChanged:Connect(function(userCFrameType, cframeValue)
	print(userCFrameType.Name .. " changed. Updated Frame: " .. tostring(cframeValue))
end)

Cet événement se déclenche lorsqu'un Enum.UserCFrame est activé ou désactivé.Il peut être utilisé aux côtés de GetUserCFrameEnabled() pour suivre si un UserCFrame spécifié est activé et quand son état change.Il peut également être utilisé aux côtés des événements et des méthodes de service UserInputService.

Puisque cet événement se déclenche localement, il ne peut être utilisé qu'en LocalScript .

Paramètres

local VRService = game:GetService("VRService")

VRService.UserCFrameEnabled:Connect(function(type, enabled)
	if enabled then
		print(type.Name .. " got enabled!")
	else
		print(type.Name .. " got disabled!")
	end
end)