VRService
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
VRService รับผิดชอบในการจัดการการโต้ตอบระหว่าง Roblox และ VR (VR) วิธีการของมัน โปรไฟล์ และอีเวนต์ช่วยให้คุณให้ประสบการณ์ที่ดีที่สุดสำหรับผู้ใช้ที่มองหาการใช้งาน Roblox บนอุปกรณ์ VR
ดู แนวปฏิบัติ VR สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเผยแพร่ประสบการณ์สำหรับอุปกรณ์ VR
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
local part = workspace.Part
local handOffset = VRService:GetUserCFrame(Enum.UserCFrame.LeftHand)
-- Account for headscale
handOffset = handOffset.Rotation + handOffset.Position * workspace.CurrentCamera.HeadScale
part.CFrame = workspace.CurrentCamera.CFrame * handOffset
สรุป
คุณสมบัติ
ปรับแต่งการเคลื่อนไหวใน VR โดยอัตโนมัติเพื่อจัดตำแหน่งผู้เล่นกับอวาตาร์ของพวกเขา
เมื่อใช่ ผู้เล่น VR เฮดเซ็ท
เมื่อใช่ มุมมองของผู้เล่น VR จะหายไปเมื่อหัวของพวกเขาชนกับวัตถุ
อธิบายสิ่งที่ Enum.UserCFrame รับผิดชอบสำหรับการป้อนข้อมูลใน VR
อธิบายว่าผู้ใช้กำลังใช้อุปกรณ์เสมือนจริงหรือไม่
วิธีการ
กลับ VRTouchpadMode ที่ระบุว่าเป็นโหมดของ VRTouchpad ที่กำหนด
กลับ CFrame ที่อธิบายตำแหน่งและการจัดเรียงของอุปกรณ์จำลองความเป็นจริงที่กำหนดเป็นออเซ็ตจากจุดในพื้นที่โลกแห่งความเป็นจริง
กลับ true หาก Enum.UserCFrame ที่กำหนดไว้สามารถฟังได้
ย้าย CFrame ไปยังตำแหน่งปัจจุบันของหมวก VR ที่สวมใส่โดยผู้ใช้
รวมทางการนำทางไปยัง CFrame โดยใช้ Enum.UserCFrame เป็นต้นที่มีสถานะเป็นต้นสำหรับวิดีโอไดรเวอร์บอล
ตั้งโหมดของ Enum.VRTouchpad เป็น Enum.VRTouchpadMode
อีเวนต์
ไฟร์เมื่อการนำทางถูกร้องขอจาก VRService
ยิงถ้า Enum.VRTouchpadMode ของ Entity.VRTouch ถูกเปลี่ยนแปลง
เปิดเมื่อ Enum.UserCFrame เปลี่ยนแปลง
เปิด/ปิดเมื่อ Enum.UserCFrame เปิดใช้งาน
คุณสมบัติ
AutomaticScaling
เมื่อตั้งค่าเป็น Enum.VRScaling.World``Class.Camera.HeadScale อวาตาร์ผู้เล่นที่มีอวตาร์ขนาดเล็กจะรับรู้วัตถุรอบตั
AvatarGestures
เมื่อตั้งค่าไว้ที่ true ผู้เล่น VR เฮดเซ็ท
คุณสมบัตินี้ต้องการติดตั้งบนเซิร์ฟเวอร์
ControllerModels
FadeOutViewOnCollision
เมื่อเป็นเช่นนั้น, มุมมองของผู้เล่น VR จะมืดเมื่อหัวของพวกเขาชนกับวัตถุ สิ่งนี้จะป้องกันผู้เล่นจากการสามารถเห็นผ่านผนังในขณะที่อยู่ใน VR สิ่งที่เป็นปกติคือค่าเริ่มต้น
GuiInputUserCFrame
สมบัตินี้อธิบายว่า Enum.UserCFrame รับผิดชอบสำหรับการป้อนข้อมูลใน VR โดยเฉพาะ เช่น หาก VR หูฟังรับผิดชอบ, มูลค่าของสมบัตินี้จะเป็น Enum.UserCFrame.Head
เพื่อตรวจสอบว่า Roblox ตรวจพบอุปกรณ์ VR ใด ๆ ซึ่งจะรับผิดชอบสำหรับการป้อนข้อมูลใน VR คุณสามารถตรวจสอบสมบัติภาพ VREnabled ได้
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
if VRService.VREnabled then
print(VRService.GuiInputUserCFrame.Name)
else
print("No VR device detected!")
end
LaserPointer
ThirdPersonFollowCamEnabled
VREnabled
สมบัตินี้อธิบายว่าผู้ใช้กำลังใช้อุปกรณ์เสมือนความเป็นจริง (VR)
หากเปิดใช้งานอุปกรณ์ VR คุณสามารถใช้งานได้ผ่านวิธีการเช่น UserInputService:GetUserCFrame() คุณยังสามารถตอบสนองต่อการเคลื่อนไหวของอุปกรณ์ VR โดยใช้เหตุการณ์ UserInputService.UserCFrameChanged
local UserInputService = game:GetService("UserInputService")local isUsingVR = UserInputService.VREnabledif isUsingVR thenprint("User is using a VR headset!")elseprint("User is not using a VR headset!")end
สมบัตินี้ใช้ได้เฉพาะใน LocalScript เท่านั้น
ดูเพิ่มเติม
ตัวอย่างโค้ด
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
วิธีการ
GetTouchpadMode
วิธีนี้กลับมาที่ Enum.VRTouchpadMode เพื่อแสดงโหมดของ Enum.VRTouchpad ที่กำหนด วิธีการกลับมานี้แสดงวิธีการที่ผู้ใช้ใช้งานแท็งก์แพดของพวกเขาเพื่อเล่นเกม
นี้ยังสามารถใช้ร่วมกับวิธีการและเหตุการณ์ VR ต่างๆ ของ UserInputService
วิธีนี้จะทำงานเฉพาะใน LocalScript เท่านั้น
พารามิเตอร์
เครื่องมือสแน็ป Enums.VRTouchpad|VRTouchpad ที่กำหนด
ส่งค่ากลับ
โหมดของ VRTouchpad
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
VRService:GetTouchpadMode(Enum.VRTouchpad.Left)
GetUserCFrame
วิธีนี้กลับค่า CFrame อุปกรณ์(VR) ที่ระบุเป็นออเซ็ตจากตำแหน่งในพื้นที่โลกแห่งความเป็นจริง วิธีนี้ควรใช้เ
โดยใช้วิธีนี้ ผู้พัฒนาสามารถใช้คุณสมบัติเช่นการเรียงตำแหน่งผู้ใช้ในเกมตรงกับตำแหน่งของอุปกรณ์ VR ที่เชื่อมต่อได้ สิ่งนี้สามารถ
VRService ยังให้เหตุการณ์ UserCFrameChanged ที่เกิดขึ้นอัตโนมัติเมื่อ CFrame ของอุปกรณ์ VR ที่เชื่อมต่อเปลี่ยนแปลง โดยใช้ใน 0>
วิธีนี้จะทำงานเฉพาะใน LocalScript เท่านั้น
พารามิเตอร์
UserCFrame|UserCFrame ที่ระบุ
ส่งค่ากลับ
ตัวอย่างโค้ด
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
GetUserCFrameEnabled
วิธีนี้จะสร้างความจริงที่เป็นไปได้หาก Enum.UserCFrame อุปกรณ์สามารถใช้เพื่อตรวจสอบว่า Enum.UserCFrame.Head เช่น จะเชื่อมต่อกับเกมข
นี้ยังสามารถใช้ร่วมกับวิธีการและเหตุการณ์ VR ต่างๆ ของ UserInputService
วิธีนี้จะทำงานเฉพาะใน LocalScript เท่านั้น
พารามิเตอร์
ประเภทที่กำหนดของ VR อุปกรณ์
ส่งค่ากลับ
ตัวเลือกที่แสดงว่าอุปกรณ์ VR ที่กำหนดเปิดใช้งานหรือไม่ ( true ) หรือไม่ได้เปิดใช้งาน ( false )
ตัวอย่างโค้ด
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
RecenterUserHeadCFrame
วิธีนี้จะนำ CFrame ของหัวผู้ใช้กลับไปยังตำแหน่งปัจจุบันของหมวก VR ที่สวมใส่โดยผู้ใช้ เฮดเซ็ท
พฤติกรรมนี้เหมือนกันกับ UserInputService:RecenterUserHeadCFrame()
วิธีนี้จะทำงานเฉพาะใน LocalScript เท่านั้น
ส่งค่ากลับ
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
VRService:RecenterUserHeadCFrame()
RequestNavigation
วิธีนี้ขอให้การนำทางไปยัง CFrame โดยใช้ Enum.UserCFrame เป็นต้นที่สำหรับวิธีการจัดการ VR ในเกมของคุณโดยการให้วิธีการเห็นวิธีการนำทางจากอุปกรณ์ V
VRService มีเหตุการณ์ที่คล้ายคลึงกัน, NavigationRequested ใช้เพื่อตรวจจับคำขอเช่นนี้ นี่ยังสามารถใช้ร่วมกับวิธีการและเหตุการณ์ต่างๆ ของ Class.UserInputService ได้
วิธีนี้จะทำงานเฉพาะใน LocalScript เท่านั้น
พารามิเตอร์
อุปกรณ์ VR สำหรับการนำทาง
ส่งค่ากลับ
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
local destination = workspace:FindFirstChild("NavigationDestination")
VRService:RequestNavigation(Enum.UserCFrame.Head, destination.CFrame)
SetTouchpadMode
วิธีนี้ตั้งโหมดของ Enum.VRTouchpad ไว้ที่ Enum.VRTouchpadMode ต้องใช้เพื่อเปลี่ยนโหมดของผู้ใช้ให้เป็นโหมดของ VR ผู้ใช้ใช้งานได้โดยการใช้ 1>แท็ชแพด1> เพื่
นี้ยังสามารถใช้ร่วมกับวิธีการและเหตุการณ์ VR ต่างๆ ของ UserInputService
วิธีนี้จะทำงานเฉพาะใน LocalScript เท่านั้น
พารามิเตอร์
The specified VRTouchpad คุณต้องการตั้งค่าโหมดของ.
โหมดที่คุณต้องการตั้ง VRTouchpad ให้
ส่งค่ากลับ
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
VRService:SetTouchpadMode(Enum.VRTouchpad.Left, Enum.VRTouchpadMode.Touch)
อีเวนต์
NavigationRequested
เหตุการณ์นี้จะเกิดขึ้นเมื่อคำขอการนำทางถูกร้องขอจาก VRService สำหรับ VR อุปกรณ์ที่กำหนด Enum.UserCFrame ด้วยความสัมพันธ์ CFrame และ
เหตุการณ์นี้สามารถใช้ร่วมกับเหตุการณ์และวิธีการให้บริการ UserInputService
เนื่องจากเหตุการณ์นี้เกิดขึ้นในพื้นที่ของเราเอง จึงสามารถใช้ได้ใน LocalScript เท่านั้น
พารามิเตอร์
ระบุอุปกรณ์ VR สำหรับการนำทางที่ต้องการ
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
VRService.TouchpadModeChanged:Connect(function(cframe, inputUserCFrame)
print(inputUserCFrame.Name .. " made request with CFrame: " .. cframe)
end)
TouchpadModeChanged
เหตุการณ์นี้จะเกิดขึ้นหาก Enum.VRTouchpadMode ของ Enum.VRTouchpad เปลี่ยนแปลงแล้ว คุณสามารถใช้เหตุการณ์นี้เพื่อติดตามสถานะของ VR แท็ปแพดผ่านทางเคลื่อนไหวของผู้ใช้
เหตุการณ์นี้สามารถใช้ร่วมกับเหตุการณ์และวิธีการให้บริการ UserInputService
เนื่องจากเหตุการณ์นี้เกิดขึ้นในพื้นที่ของเราเอง จึงสามารถใช้ได้ใน LocalScript เท่านั้น
พารามิเตอร์
แผงสัมผัสที่เปลี่ยนโหมด
โหมดใหม่
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
VRService.NavigationRequested:Connect(function(pad, mode)
print(pad.Name .. " Touchpad changed to state: " .. mode.Name)
end)
UserCFrameChanged
เหตุการณ์นี้จะเกิดขึ้นเมื่อ Enum.UserCFrame เปลี่ยนแปลง เช่นเมื่อผู้ใช้ย้ายอุปกรณ์ VR ที่เชื่อมต่อ ตัวอย่างเช่
เนื่องจากเหตุการณ์นี้เกิดขึ้นในพื้นที่ของเราเอง จึงสามารถใช้ได้ใน LocalScript เท่านั้น
พารามิเตอร์
ประเภทของ VR อุปกรณ์ที่เปลี่ยนแปลง
ตัวอย่างโค้ด
local VRService = game:GetService("VRService")
VRService.UserCFrameChanged:Connect(function(userCFrameType, cframeValue)
print(userCFrameType.Name .. " changed. Updated Frame: " .. tostring(cframeValue))
end)
UserCFrameEnabled
เหตุการณ์นี้จะเกิดขึ้นเมื่อ Enum.UserCFrame เปิดใช้งานหรือไม่มีอยู่ สามารถใช้ร่วมกับ GetUserCFrameEnabled() เพื่อติดต
เนื่องจากเหตุการณ์นี้เกิดขึ้นในพื้นที่ของเราเอง จึงสามารถใช้ได้ใน LocalScript เท่านั้น
พารามิเตอร์
The UserCFrame กำลังเปิดใช้งานหรือปิดใช้งาน
ตัวเลือกที่แสดงว่า UserCFrame เปิดใช้งาน ( true ) หรือไม่ได้เปิดใช้งาน ( false )
ตัวอย่างโค้ด
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)