`ViewportCamera` là một `Class.Camera` được thiết kế cho các camera mà bạn thiết lập tại
tiết kế, chẳng hạn như một camera được gán cho `Class.ViewportFrame.CurrentCamera`
hoặc một `ThumbnailCamera` bên trong một `Class.Model`. Nó có cùng các thuộc tính,
phương thức và sự kiện như `Class.Camera`, nhưng không giống như `Class.Camera`, nó
sao chép, vì vậy nó hoạt động như mong đợi trong Team Create và khi được sao chép từ
máy chủ đến các client.

Sử dụng một `Class.Camera` cho camera hiển thị thế giới 3D, có thể truy cập
thông qua `Class.Workspace.CurrentCamera`. Sử dụng một `ViewportCamera` cho bất kỳ camera nào
mà bạn tạo và muốn lưu cùng với địa điểm.

#### Hành vi Tự động nâng cấp

Khi bạn dán nội dung đã sao chép chứa một `Class.Camera` trong Studio, bất kỳ
`Class.Camera` nào cũng sẽ tự động được chuyển đổi thành một `ViewportCamera` với các
thuộc tính giống nhau. Điều này nhằm tạo điều kiện cho quy trình làm việc phổ biến của việc thiết lập một
camera bằng cách định vị camera chính của workspace và sau đó sao chép-dán camera đó.


ViewportCamera

Một `Class.Camera` sao chép và được lưu dưới dạng nội dung do tác giả tạo, để sử dụng
với `Class.ViewportFrame|ViewportFrames` hoặc như một ThumbnailCamera.


Đối tượng `Camera` định nghĩa một cái nhìn của thế giới 3D. Trong một trải nghiệm đang chạy,
mỗi client có đối tượng `Camera` riêng của mình nằm trong `Class.Workspace` cục bộ của client đó,
được truy cập thông qua thuộc tính `Class.Workspace.CurrentCamera`.

Các thuộc tính camera quan trọng nhất là:

- `Class.Camera.CFrame|CFrame` đại diện cho vị trí và hướng
  của camera.

- `Class.Camera.CameraType|CameraType` được đọc bởi các
  script camera của trải nghiệm và xác định cách camera nên cập nhật mỗi khung hình.

- `Class.Camera.CameraSubject|CameraSubject` được đọc bởi các
  script camera của trải nghiệm và xác định đối tượng mà camera nên theo dõi.

- `Class.Camera.FieldOfView|FieldOfView` đại diện cho phạm vi nhìn thấy
  của thế giới quan sát được.

- `Class.Camera.Focus|Focus` đại diện cho điểm mà camera đang nhìn
  vào. Quan trọng là thuộc tính này được thiết lập, vì một số hình ảnh sẽ chi tiết hơn
  và sẽ cập nhật thường xuyên hơn tùy thuộc vào độ gần của chúng với
  điểm tiêu điểm.

Xem [Tùy chỉnh Camera](/workspace/camera) để biết thêm
thông tin về cách điều chỉnh và tùy chỉnh hành vi của camera.

#### Lưu trữ Nhiều Camera

Lưu ý rằng khi thay đổi `Class.Workspace.CurrentCamera` thành một
`Class.Camera` mới, tất cả các `Class.Camera|Cameras` khác trực tiếp kế thừa từ
`Class.Workspace` sẽ bị xóa. Nếu bạn cần lưu trữ nhiều camera và
hoán đổi giữa chúng theo yêu cầu, nên lưu trữ chúng trong một
`Class.Folder` hoặc `Class.Model` dưới `Class.Workspace`, bên trong đó chúng
sẽ vẫn tồn tại ngay cả khi `Class.Workspace.CurrentCamera|CurrentCamera` bị
thay đổi.

Sự kiện này được kích hoạt khi `Class.Camera` đã hoàn thành việc nội suy bằng
phương pháp `Class.Camera:Interpolate()`. Nó sẽ không được kích hoạt nếu một tween bị
ngắt quãng do `Class.Camera:Interpolate()` được gọi lại.

Bạn được khuyên nên sử dụng `Class.TweenService` để hoạt hình `Class.Camera`
thay vào đó, vì nó đáng tin cậy hơn và cung cấp nhiều tùy chọn cho các kiểu easing.

Camera.InterpolationFinished

Kích hoạt khi `Class.Camera` đã hoàn thành việc nội suy
sử dụng `Class.Camera:Interpolate()|Interpolate()`.

Phương pháp này được sử dụng bởi `PopperCam` trong các script camera mặc định để đảm bảo
các vật cản không nằm giữa `Class.Camera` và đối tượng của nó.

Phương pháp này sẽ kiểm tra tất cả các `Class.BasePart|BaseParts` và `Class.Terrain`
trong `Class.Workspace` với các ngoại lệ sau:

- Bất kỳ `Class.Instance` nào được chỉ định trong `ignoreList` (bao gồm cả các
  con cháu của nó) sẽ bị bỏ qua
- `Class.BasePart|BaseParts` có `Class.BasePart.CanCollide` được thiết lập thành false
  sẽ bị bỏ qua
- `Class.BasePart|BaseParts` có `Class.BasePart.Transparency` lớn hơn
  0.95 sẽ bị bỏ qua. Nước `Class.Terrain` sẽ bị bỏ qua.

Lưu ý, vì phương pháp này yêu cầu một `ignoreList` để chạy, bạn nên truyền một
bảng rỗng khi không cần thiết.

Camera:GetLargestCutoffDistance

ignoreList

Một mảng `Class.Instance|Instances` để bỏ qua. Các con cháu của các
instance này cũng sẽ bị bỏ qua.

Khoảng cách, tính bằng studs, mà `Class.Camera` cần được đẩy
về phía `Class.Camera.Focus|Focus` để đảm bảo không có
vật cản giữa `Class.Camera.Focus|Focus` và
`Class.Camera.CFrame|CFrame` của `Class.Camera`.

Trả về khoảng cách mà `Class.Camera` cần được đẩy về phía
`Class.Camera.Focus|Focus` để đảm bảo không có vật cản
giữa `Class.Camera.Focus|Focus` và `Class.Camera.CFrame|CFrame`.

Phương pháp này bị hỏng và không nên được sử dụng.

Phương pháp này trả về tốc độ pan hiện tại của `Class.Camera`.

Tốc độ pan của `Class.Camera` mô tả tốc độ mà `Class.Camera`
đang xoay quanh `Class.Camera.Focus|Focus` quanh trục **Y**.

Camera:GetPanSpeed

Tốc độ mà `Class.Camera` đang xoay quanh `Class.Camera.Focus|Focus` trên trục **Y**.

Trả về tốc độ 'pan' hiện tại của `Class.Camera`.

Phương pháp này trả về một mảng `Class.BasePart|BaseParts` đang
che khuất các đường nhìn giữa `Class.Camera.CFrame|CFrame` của camera và các
vị trí `Datatype.Vector3` trong mảng `castPoints`. Bất kỳ `Class.Instance|Instances` nào
được bao gồm trong mảng `ignoreList` sẽ bị bỏ qua, cùng với các con cháu của chúng.

Tham số `castPoints` được đưa ra dưới dạng một mảng các vị trí `Datatype.Vector3`. Lưu ý rằng mảng `Class.BasePart|BaseParts` được trả về là
trong một thứ tự tùy ý, và không có dữ liệu raycast bổ sung nào được cung cấp. Nếu bạn
cần dữ liệu như vị trí va chạm, vật liệu va chạm, hoặc bề mặt pháp tuyến, bạn
nên chọn phương pháp `Class.WorldRoot:Raycast()`.

```lua
local camera = workspace.CurrentCamera

local castPoints = {
	Vector3.new(0, 10, 0),
	Vector3.new(0, 15, 0)
}
local ignoreList = {}

local partsObscuringTarget = camera:GetPartsObscuringTarget(castPoints, ignoreList)
```
Nếu `Class.Terrain` che khuất một điểm phát, các `Class.BasePart|BaseParts`
che khuất điểm phát giữa `Class.Terrain` che khuất và điểm phát sẽ không được trả về.

Camera:GetPartsObscuringTarget

castPoints

Một mảng các vị trí `Datatype.Vector3` của các điểm phát.

Một mảng `Class.Instance|Instances` mà nên bị bỏ qua, cùng
với các con cháu của chúng.

Một mảng `Class.BasePart|BaseParts` đang che khuất các đường nhìn
giữa `Class.Camera.CFrame|CFrame` của camera và các
`castPoints`.

Trả về một mảng `Class.BasePart|BaseParts` đang che khuất các
đường nhìn giữa `Class.Camera.CFrame|CFrame` của camera và các
điểm phát.

Phương pháp này trả về `Datatype.CFrame` thực tế của `Class.Camera` khi
nó được render, bao gồm tác động của VR (các biến đổi đầu VR không được áp dụng cho thuộc tính `Class.Camera.CFrame|CFrame`, vì vậy tốt nhất là sử dụng `Class.Camera:GetRenderCFrame()|GetRenderCFrame()` để
có được `Datatype.CFrame` "thực sự" của cái nhìn của người chơi).

Ví dụ, khi sử dụng VR, `Class.Camera` thực sự được render tại
`Datatype.CFrame` sau:

```lua
local UserInputService = game:GetService("UserInputService")

local camera = workspace.CurrentCamera

local headCFrame = UserInputService:GetUserCFrame(Enum.UserCFrame.Head)
headCFrame = headCFrame.Rotation + headCFrame.Position * camera.HeadScale
renderCFrame = camera.CFrame * headCFrame
```

`Datatype.CFrame` render của camera chỉ được thay đổi để tính đến
đầu khi thuộc tính `Class.Camera.HeadLocked|HeadLocked` là true.

Camera:GetRenderCFrame

`Datatype.CFrame` mà `Class.Camera` đang được render tại.

Trả về `Datatype.CFrame` thực tế mà `Class.Camera` đang
được render, tính đến bất kỳ độ lăn nào được áp dụng và tác động của các thiết bị VR.

Ví dụ này, khi được sử dụng trong một `Class.LocalScript`, sẽ lấy giá trị
cuộn hiện tại của camera tính bằng độ. Sau đó, nếu góc cuộn của camera không phải là 20
độ, góc cuộn của camera sẽ được đặt thành 20 độ.


Phương pháp này trả về, tính bằng radian, độ lăn hiện tại được áp dụng cho
`Class.Camera` bằng `Class.Camera:SetRoll()|SetRoll()`. Độ lăn được định nghĩa
là xoay quanh trục Z của camera.

Phương pháp này chỉ trả về độ lăn được áp dụng bằng
phương pháp `Class.Camera:SetRoll()|SetRoll()`. Độ lăn được áp dụng thủ công cho
`Class.Camera.CFrame|CFrame` của camera không được tính đến. Để có được
độ lăn thực tế của `Class.Camera`, bao gồm cả độ lăn được áp dụng thủ công, bạn
có thể sử dụng đoạn mã sau:

Camera:GetRoll

Độ lăn hiện tại được áp dụng bởi `Class.Camera:SetRoll()|SetRoll()`, tính bằng
radian.

Trả về độ lăn hiện tại, tính bằng radian, hoặc xoay quanh trục Z của camera,
được áp dụng cho `Class.Camera` bằng
`Class.Camera:SetRoll()|SetRoll()`.

Phương pháp này bị hỏng và không nên được sử dụng.

Phương pháp này trả về tốc độ nghiêng hiện tại của `Class.Camera`.

Tốc độ nghiêng của `Class.Camera` mô tả tốc độ mà `Class.Camera`
đang xoay quanh `Class.Camera.Focus|Focus` quanh trục **X** của camera.

Camera:GetTiltSpeed

Tốc độ mà `Class.Camera` đang xoay quanh `Class.Camera.Focus|Focus` quanh trục **X** của camera.

Trả về tốc độ nghiêng hiện tại của `Class.Camera`.

Phương pháp này tween `Class.Camera` theo cách tuyến tính về một `Class.Camera.CFrame|CFrame` và `Class.Camera.Focus|Focus` mới trong một khoảng thời gian nhất định, ví dụ:

```lua
local camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable

camera:Interpolate(
	CFrame.new(0, 10, 100),
	CFrame.new(0, 0, 100),
	5
)
```
Trong suốt quá trình tween, `Class.Camera.CFrame|CFrame` của camera sẽ được
định hướng về phía `Class.Camera.Focus|Focus` của camera.

Khi quá trình tween hoàn tất, sự kiện
`Class.Camera.InterpolationFinished|InterpolationFinished` của camera sẽ
được kích hoạt.

Nếu phương pháp này được gọi trong khi `Class.Camera` đã đang tween, quá trình tween cũ sẽ bị dừng lại (mà không kích hoạt
`Class.Camera.InterpolationFinished|InterpolationFinished`) và bị ghi đè
bởi tween mới.

Interpolate chỉ có thể được sử dụng nếu `Class.Camera.CameraType|CameraType` hiện tại là `Scriptable`, bất kể
các script camera mặc định có đang được sử dụng hay không. Nếu nó được sử dụng với bất kỳ
`Class.Camera.CameraType|CameraType` nào khác, một lỗi sẽ được ném ra.

Bạn được khuyên nên sử dụng `Class.TweenService` để tween `Class.Camera`
thay vì vì nó đáng tin cậy hơn và cung cấp nhiều kiểu easing khác nhau. Xem
dưới đây để biết một ví dụ:

```lua
local TweenService = game:GetService("TweenService")

local camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable

local tween = TweenService:Create(
	camera,
	TweenInfo.new(5, Enum.EasingStyle.Quad, Enum.EasingDirection.Out),
	{
		CFrame = CFrame.new(0, 10, 100),
		Focus = CFrame.new(0, 0, 100)
	}
)

tween:Play()
```

Camera:Interpolate

endPos

`Datatype.CFrame` mà `Class.Camera` sẽ tween đến.

endFocus

`Datatype.CFrame` mà `Class.Camera.Focus|Focus` của camera sẽ tween đến.

duration

Thời gian, tính bằng giây, của tween.

Tween `Class.Camera` theo cách tuyến tính về một `Class.Camera.CFrame|CFrame` và `Class.Camera.Focus|Focus` mới trong một khoảng thời gian nhất định.

Phương pháp này pan `Class.Camera` quanh `Class.Camera.Focus|Focus`
theo các bước 45 độ quanh trục **Y**.

Sự xoay được áp dụng cho thuộc tính `Class.Camera.CFrame|CFrame` của camera.

Phương pháp này pan `Class.Camera` theo các bước 45 độ, ví dụ:

```lua
workspace.CurrentCamera:PanUnits(1) -- 45 độ
workspace.CurrentCamera:PanUnits(-2) -- -90 độ
```
PanUnits không yêu cầu `Class.Camera.CameraType|CameraType` phải là
`Scriptable`.

Camera:PanUnits

units

Số bước 45 độ mà `Class.Camera` sẽ pan.

Pan `Class.Camera` quanh `Class.Camera.Focus|Focus` theo các bước 45 độ
quanh trục **Y**.

Phương pháp này tạo một `Datatype.Ray` đơn vị từ một vị trí 2D trên màn hình
(được định nghĩa bằng pixel), tính đến độ lùi của GUI. `Datatype.Ray`
xuất phát từ `Datatype.Vector3` tương đương với vị trí 2D trong
thế giới ở độ sâu nhất định (tính bằng studs) từ `Class.Camera`.

Vì phương pháp này tính đến độ lùi của GUI, độ lệch áp dụng cho các phần tử GUI
(chẳng hạn như từ thanh trên) được tính đến. Điều này có nghĩa là vị trí
màn hình được chỉ định sẽ bắt đầu từ góc trên bên trái dưới thanh trên. Đối với một phương pháp tương tự mà không tính đến độ lệch GUI,
bạn có thể sử dụng `Class.Camera:ViewportPointToRay()|ViewportPointToRay()`.

Vì `Datatype.Ray` được tạo ra là một ray đơn vị, nó chỉ dài một stud. Để
tạo một ray dài hơn, bạn có thể làm như sau:

```lua
local camera = workspace.CurrentCamera
local length = 500
local unitRay = camera:ScreenPointToRay(100, 100)
local extendedRay = Ray.new(unitRay.Origin, unitRay.Direction * length)
```
Phương pháp này chỉ hoạt động cho camera hiện tại của `Class.Workspace`. Các
camera khác, chẳng hạn như những camera bạn tạo cho một `Class.ViewportFrame`, có
kích thước viewport ban đầu là <Typography noWrap>`(1, 1)`</Typography> và chỉ được cập nhật sau khi bạn thiết lập chúng thành
`Class.Workspace.CurrentCamera`. Sự không khớp về kích thước viewport khiến camera trả về một ray với
`Datatype.Ray.Direction` không chính xác.

Camera:ScreenPointToRay

Vị trí trên trục **X**, tính bằng pixel, của điểm trên màn hình mà
`Datatype.Ray` sẽ xuất phát. Vị trí này tính đến độ lùi của GUI.

Vị trí trên trục **Y**, tính bằng pixel, của điểm trên màn hình mà
`Datatype.Ray` sẽ xuất phát. Vị trí này tính đến độ lùi của GUI.

depth

Độ sâu từ `Class.Camera`, tính bằng studs, từ đó để dịch chuyển
nguồn gốc của `Datatype.Ray`.

Một `Datatype.Ray` đơn vị, xuất phát từ vị trí thế giới tương đương
`Datatype.Vector3` của các tọa độ màn hình đã cho ở
độ sâu đã cho từ `Class.Camera`. Ray này được định hướng
theo hướng của `Class.Camera`.

Tạo một `Datatype.Ray` đơn vị từ một vị trí trên màn hình (tính bằng pixel),
tại một độ sâu nhất định từ `Class.Camera` được định hướng theo hướng của camera. Tính đến độ lùi của GUI.

Phương pháp này thiết lập `Enum.CameraPanMode` sẽ được sử dụng bởi `Class.Camera`
trên các thiết bị di động.

Khi chế độ `EdgeBump` của `Enum.CameraPanMode` được sử dụng, việc vuốt để pan sẽ
bị vô hiệu hóa và các điều khiển camera edge bump sẽ được kích hoạt.

Chế độ SetCameraPan không ảnh hưởng đến người dùng Windows hoặc Mac.

Camera:SetCameraPanMode

mode

`Enum.CameraPanMode` để thiết lập cho `Class.Camera`.

Thiết lập `Enum.CameraPanMode` sẽ được sử dụng bởi `Class.Camera` trên các
thiết bị di động.

Phương pháp này đã lỗi thời và không còn được coi là thực tiễn tốt nhất.

Phương pháp này thiết lập độ lăn hiện tại, tính bằng radian, của `Class.Camera`. Độ lăn được áp dụng sau `Class.Camera.CFrame|CFrame` và đại diện cho
xoay quanh trục Z của camera.

Ví dụ, đoạn mã sau sẽ đảo ngược `Class.Camera`:

```lua
workspace.CurrentCamera:SetRoll(math.pi) -- math.pi radian = 180 độ
```
SetRoll không ảnh hưởng đến bất kỳ độ lăn nào được áp dụng bằng
thuộc tính `Class.Camera.CFrame|CFrame`. Độ lăn được áp dụng bằng SetRoll không được
phản ánh trong thuộc tính `Class.Camera.CFrame|CFrame` nhưng được phản ánh trong
`Datatype.CFrame` được trả về
bởi `Class.Camera:GetRenderCFrame()|GetRenderCFrame()`.

Phương pháp này chỉ có thể được sử dụng khi `Class.Camera.CameraType|CameraType`
được thiết lập thành `Scriptable`, bất kể các script camera mặc định có đang được sử dụng hay không. Nếu nó được sử dụng với bất kỳ
`Class.Camera.CameraType|CameraType` nào khác, một cảnh báo sẽ được đưa ra trong đầu ra.

Bất kỳ độ lăn nào được áp dụng bằng phương pháp này sẽ bị mất khi
`Class.Camera.CameraType|CameraType` được thay đổi từ `Scriptable`.

Để có được độ lăn được thiết lập bằng phương pháp này, hãy sử dụng
`Class.Camera:GetRoll()|GetRoll()`.

Vì phương pháp này đã lỗi thời, bạn được khuyên nên áp dụng độ lăn cho
`Class.Camera` bằng thuộc tính `Class.Camera.CFrame|CFrame`. Ví dụ:

```lua
local currentCFrame = workspace.CurrentCamera.CFrame
local rollCFrame = CFrame.Angles(0, 0, roll)
workspace.CurrentCamera.CFrame = currentCFrame * rollCFrame
```

Camera:SetRoll

rollAngle

Góc lăn, tính bằng radian, sẽ được áp dụng cho `Class.Camera`.

Thiết lập độ xoay hiện tại áp dụng quanh trục Z của camera.

Phương pháp này nghiêng `Class.Camera` bằng cách xoay nó quanh
`Class.Camera.Focus|Focus` quanh trục **X** của camera theo một bội số nhất định của 10 độ.

Sự xoay được áp dụng cho thuộc tính `Class.Camera.CFrame|CFrame` của camera và bị giới hạn giữa `-81.05` và `81.05` độ.

Camera:TiltUnits

Số đơn vị 10 độ mà `Class.Camera` sẽ nghiêng.

Liệu độ nghiêng của `Class.Camera` được áp dụng có bị giới hạn hay không.

Nghiêng `Class.Camera` quanh `Class.Camera.Focus|Focus` theo các bước 10
độ quanh trục **X** của camera.

Phương pháp này tạo một `Datatype.Ray` đơn vị từ một vị trí 2D trong tọa độ viewport an toàn của thiết bị, được định nghĩa bằng pixel. Ray xuất phát từ
`Datatype.Vector3` tương đương với vị trí 2D trong thế giới ở độ sâu nhất định (tính bằng studs) từ `Class.Camera`.

Như được minh họa bên dưới, `(0, 0)` tương ứng với điểm trên cùng bên trái của
thanh trên Roblox. Điều này có nghĩa là vị trí 2D đầu vào không tính đến
độ lùi của `Enum.ScreenInsets|CoreUISafeInsets`, nhưng nó tính đến bất kỳ
độ lùi nào của `Enum.ScreenInsets|DeviceSafeInsets`.

<img src="../../../assets/engine-api/classes/Camera/ViewportPointToRayOrigin.png" width="840" alt="Sơ đồ cho thấy nguồn gốc của hệ thống tọa độ viewport an toàn của thiết bị." />

Lưu ý rằng các instance UI sử dụng một hệ thống tọa độ khác
(`Class.GuiObject.AbsolutePosition` sử dụng hệ thống tọa độ viewport của
`Enum.ScreenInsets|CoreUISafeInsets` trong khi phương pháp này sử dụng hệ thống tọa độ viewport của
`Enum.ScreenInsets|DeviceSafeInsets`). Nếu bạn muốn chỉ định vị trí trong tọa độ UI chính,
xin vui lòng sử dụng `Class.Camera:ScreenPointToRay()|ScreenPointToRay()`.

Cũng lưu ý rằng phương pháp này chỉ hoạt động cho camera
`Class.Workspace.CurrentCamera`. Các camera khác, chẳng hạn như những camera bạn
tạo cho một `Class.ViewportFrame`, có kích thước viewport ban đầu là
`(1, 1)` và chỉ được cập nhật sau khi bạn thiết lập chúng thành
`Class.Workspace.CurrentCamera|CurrentCamera`. Sự không khớp về kích thước viewport khiến camera trả về một ray với
`Datatype.Ray.Direction` không chính xác.

Phương pháp này có thể được sử dụng kết hợp với thuộc tính
`Class.Camera.ViewportSize|ViewportSize` để tạo một ray từ trung tâm của màn hình, ví dụ:

```lua
local camera = workspace.CurrentCamera

local viewportPoint = camera.ViewportSize / 2
local unitRay = camera:ViewportPointToRay(viewportPoint.X, viewportPoint.Y, 0)
```
Vì `Datatype.Ray` được tạo ra là một ray đơn vị, nó chỉ dài một stud. Để
tạo một ray dài hơn, bạn có thể làm như sau:

```lua
local camera = workspace.CurrentCamera

local length = 500
local viewportPoint = camera.ViewportSize / 2
local unitRay = camera:ViewportPointToRay(viewportPoint.X, viewportPoint.Y, 0)
local extendedRay = Ray.new(unitRay.Origin, unitRay.Direction * length)
```

Camera:ViewportPointToRay

Vị trí trên trục **X**, tính bằng pixel, của điểm viewport mà
`Datatype.Ray` sẽ xuất phát, trong tọa độ an toàn của thiết bị.

Vị trí trên trục **Y**, tính bằng pixel, của điểm viewport mà
`Datatype.Ray` sẽ xuất phát, trong tọa độ an toàn của thiết bị.

Một `Datatype.Ray` đơn vị, xuất phát từ vị trí thế giới tương đương
`Datatype.Vector3` của các tọa độ viewport đã cho ở
độ sâu đã cho từ `Class.Camera`. Ray này được định hướng
theo hướng của `Class.Camera`.

Tạo một `Datatype.Ray` đơn vị từ một vị trí trên viewport (tính bằng pixel),
tại một độ sâu nhất định từ `Class.Camera`, được định hướng theo hướng của camera. Không tính đến độ lùi của `Enum.ScreenInsets|CoreUISafeInsets`.

Phương pháp này trả về vị trí màn hình và độ sâu của một `Datatype.Vector3`
`worldPoint` và liệu điểm này có nằm trong giới hạn của màn hình hay không.

Phương pháp này tính đến độ lùi GUI hiện tại, chẳng hạn như không gian
chiếm bởi thanh trên, có nghĩa là vị trí 2D được trả về là trong cùng một
thuật ngữ như các vị trí GUI và có thể được sử dụng để đặt các phần tử GUI. Đối với một phương pháp tương tự mà không tính đến độ lùi GUI, xem
`Class.Camera:WorldToViewportPoint()|WorldToViewportPoint()`.

```lua
local camera = workspace.CurrentCamera

local worldPoint = Vector3.new(0, 10, 0)
local vector, onScreen = camera:WorldToScreenPoint(worldPoint)

local screenPoint = Vector2.new(vector.X, vector.Y)
local depth = vector.Z
```
Lưu ý rằng phương pháp này không thực hiện bất kỳ raycasting nào và giá trị boolean
cho biết liệu `worldPoint` có nằm trong giới hạn của màn hình sẽ là
`true` bất kể điểm có bị che khuất bởi
`Class.BasePart|BaseParts` hoặc `Class.Terrain` hay không.

Camera:WorldToScreenPoint

worldPoint

Vị trí thế giới `Datatype.Vector3`.

Một tuple chứa, theo thứ tự:

- Một `Datatype.Vector3` mà các thành phần **X** và **Y** đại diện cho
  độ lệch của `worldPoint` từ góc trên bên trái của màn hình,
  tính bằng pixel. Thành phần **Z** của `Datatype.Vector3` đại diện cho
  độ sâu của `worldPoint` từ màn hình (tính bằng studs).

- Một boolean cho biết liệu `worldPoint` có nằm trong giới hạn của
  màn hình hay không.

Trả về vị trí màn hình và độ sâu của một `Datatype.Vector3` `worldPoint`
và liệu điểm này có nằm trong giới hạn của màn hình hay không. Tính đến
độ lùi của GUI.

Phương pháp này trả về vị trí màn hình và độ sâu của một `Datatype.Vector3`
`worldPoint` và liệu điểm này có nằm trong giới hạn của màn hình hay không.

Phương pháp này không tính đến độ lùi GUI hiện tại, chẳng hạn như không gian
chiếm bởi thanh trên, có nghĩa là vị trí 2D được trả về được
lấy từ góc trên bên trái của viewport. Trừ khi bạn đang sử dụng
`Class.ScreenGui.IgnoreGuiInset`, vị trí này không phù hợp để
đặt các phần tử GUI.

Đối với một phương pháp tương tự mà tính đến độ lùi GUI, xem
`Class.Camera:WorldToScreenPoint()|WorldToScreenPoint()`.

```lua
local camera = workspace.CurrentCamera

local worldPoint = Vector3.new(0, 10, 0)
local vector, onScreen = camera:WorldToViewportPoint(worldPoint)

local viewportPoint = Vector2.new(vector.X, vector.Y)
local depth = vector.Z
```
Lưu ý rằng phương pháp này không thực hiện bất kỳ raycasting nào và giá trị boolean
cho biết liệu `worldPoint` có nằm trong giới hạn của màn hình sẽ là
`true` bất kể điểm có bị che khuất bởi
`Class.BasePart|BaseParts` hoặc `Class.Terrain` hay không.

##### Camera trong ViewportFrame

Chỉ có `Class.Workspace.CurrentCamera` có kích thước viewport nội bộ của nó
được engine cập nhật mỗi khung hình. Các camera được sử dụng bên trong một
`Class.ViewportFrame` không nhận được cập nhật viewport, vì vậy các thành phần X và Y
được trả về bởi phương pháp này sẽ nằm trong khoảng [0, 1] thay vì
tính bằng pixel. Trong thực tế, điều này có nghĩa là các giá trị được trả về có thể được sử dụng như
các tọa độ tỷ lệ (ví dụ,
`Datatype.UDim2|UDim2.fromScale(vector.X, vector.Y)`) để định vị các phần tử GUI
liên quan đến ViewportFrame.

Camera:WorldToViewportPoint

Một tuple chứa, theo thứ tự:

- Một `Datatype.Vector3` mà các thành phần **X** và **Y** đại diện cho
  độ lệch của `worldPoint` từ góc trên bên trái của viewport,
  tính bằng pixel cho `Class.Workspace.CurrentCamera`. Đối với các camera bên trong một
  `Class.ViewportFrame`, các giá trị được chuẩn hóa thành [0, 1]. Thành phần
  **Z** của `Datatype.Vector3` đại diện cho độ sâu của
  `worldPoint` từ màn hình (tính bằng studs).

- Một boolean cho biết liệu `worldPoint` có nằm trong giới hạn của
  màn hình hay không.

Trả về vị trí màn hình và độ sâu của một `Datatype.Vector3` `worldPoint`
và liệu điểm này có nằm trong giới hạn của màn hình hay không. Không
tính đến độ lùi của GUI.

Minh họa `Class.Camera:ZoomToExtents()`.


Phương pháp này điều chỉnh `Class.Camera.CFrame|CFrame` để một hộp giới hạn được chỉ định hoàn toàn
có thể nhìn thấy trong viewport của camera, mà không cắt bất kỳ phần nào của hộp.

Hộp giới hạn được định nghĩa bởi trung tâm và hướng của nó
(`boundingBoxCFrame`) và kích thước của nó (`boundingBoxSize`).

Điều này có thể được sử dụng để tập trung camera vào một đối tượng 3D hoặc mô hình, chẳng hạn như khi
căn chỉnh nội dung trong một `Class.ViewportFrame`, chụp ảnh màn hình, hoặc
chuyển tiếp mượt mà camera để làm nổi bật nội dung cụ thể.

Phương pháp này tự động tính đến trường nhìn của camera và
tỷ lệ khung hình viewport để đảm bảo toàn bộ hộp giới hạn vừa vặn.

Camera:ZoomToExtents

boundingBoxCFrame

`Datatype.CFrame` đại diện cho trung tâm và hướng của hộp giới hạn để vừa vặn vào viewport.

boundingBoxSize

Kích thước `Datatype.Vector3` của hộp giới hạn để vừa vặn vào viewport.

Điều chỉnh `Class.Camera.CFrame|CFrame` để hộp giới hạn được chỉ định hoàn toàn
có thể nhìn thấy trong viewport của camera.

Camera

Minh họa `Class.Camera.CameraSubject`.


`CameraSubject` chấp nhận nhiều loại `Class.Instance|Instances`. Các
script camera mặc định phản ứng khác nhau với các cài đặt có sẵn:

- Theo mặc định, các script camera theo dõi `Class.Humanoid` của nhân vật cục bộ,
  tính đến trạng thái hiện tại của humanoid và
  `Class.Humanoid.CameraOffset`.

- Khi được thiết lập thành một `Class.BasePart`, các script camera theo dõi vị trí của nó,
  với một độ lệch theo chiều dọc trong trường hợp của `Class.VehicleSeat|VehicleSeats`.

`CameraSubject` không thể được thiết lập thành `nil`. Cố gắng làm như vậy sẽ đưa nó
trở lại giá trị trước đó.

Để khôi phục `CameraSubject` về giá trị mặc định, hãy thiết lập nó thành `Class.Humanoid` của nhân vật cục bộ:

Camera.CameraSubject

`Class.Humanoid` hoặc `Class.BasePart` là đối tượng chủ đề của `Class.Camera`.

Các script camera mặc định của Roblox có một số hành vi tích hợp sẵn. Thiết lập
thuộc tính này sẽ chuyển đổi giữa các hành vi `Enum.CameraType` khác nhau.
Lưu ý rằng một số loại camera yêu cầu một
`Class.Camera.CameraSubject|CameraSubject` hợp lệ để hoạt động chính xác.

Các script camera mặc định sẽ không di chuyển hoặc cập nhật camera nếu
`CameraType` được thiết lập thành `Enum.CameraType.Scriptable`. Để biết thêm thông tin
về việc định vị và định hướng camera một cách thủ công, xem
`Class.Camera.CFrame|CFrame`.

Đối với tất cả các cài đặt `CameraType` **ngoại trừ** `Enum.CameraType.Scriptable`, thuộc tính
`Class.Camera.CameraSubject|CameraSubject` đại diện cho đối tượng
mà vị trí của `Class.Camera.Focus|Focus` được thiết lập.

Camera.CameraType

Chỉ định `Enum.CameraType` sẽ được đọc bởi các script camera.

Thuộc tính này là `Datatype.CFrame` của `Class.Camera`, xác định vị trí và hướng của nó
trong thế giới 3D. Lưu ý rằng một số biến đổi,
như việc xoay đầu khi sử dụng thiết bị VR, không được phản ánh
trong thuộc tính này, vì vậy bạn nên sử dụng
`Class.Camera:GetRenderCFrame()|GetRenderCFrame()` để có được "thực sự"
`Datatype.CFrame` của camera.

Bạn có thể di chuyển camera bằng cách thiết lập thuộc tính này. Tuy nhiên, các
script camera mặc định cũng thiết lập nó, vì vậy bạn nên:

- Thiết lập `Class.Camera.CameraType|CameraType` của camera thành
  `Enum.CameraType.Scriptable` để các script camera mặc định sẽ không
  cập nhật `Datatype.CFrame` của camera. Phương pháp này là đơn giản nhất và
  được khuyến nghị trong hầu hết các trường hợp.

- Hoàn toàn thay thế các script camera mặc định bằng các lựa chọn thay thế. Phương pháp này
  chỉ được khuyến nghị nếu bạn không cần bất kỳ chức năng camera mặc định nào.

Cách trực quan nhất để định vị và định hướng `Class.Camera` là sử dụng
constructor `Datatype.CFrame.lookAt()`. Trong ví dụ sau, `Class.Camera` được định vị tại
`Datatype.Vector3.new(0, 10, 0)` và được định hướng để nhìn về phía
`Datatype.Vector3.new(10, 0, 0)`.

```lua
local camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable

local pos = Vector3.new(0, 10, 0)
local lookAtPos = Vector3.new(10, 0, 0)

camera.CFrame = CFrame.lookAt(pos, lookAtPos)
```
Mặc dù camera có thể được đặt theo cách được trình bày ở trên, bạn
có thể muốn hoạt hình nó để di chuyển mượt mà từ một `Datatype.CFrame` đến
một cái khác. Để làm điều này, bạn có thể:

- Thiết lập vị trí/hướng của camera mỗi khung hình với
  `Class.RunService:BindToRenderStep()` và phương pháp `Datatype.CFrame:Lerp()`.
- Tạo và phát một `Class.Tween` mà hoạt hình vị trí/hướng
  của camera:

  
```lua
local Players = game:GetService("Players")
  local TweenService = game:GetService("TweenService")

  local camera = workspace.CurrentCamera
  camera.CameraType = Enum.CameraType.Scriptable

  local player = Players.LocalPlayer
  local character = player.Character
  if not character or character.Parent == nil then
  	character = player.CharacterAdded:Wait()
  end

  local pos = camera.CFrame * Vector3.new(0, 20, 0)
  local lookAtPos = character.PrimaryPart.Position
  local targetCFrame = CFrame.lookAt(pos, lookAtPos)

  local tween = TweenService:Create(camera, TweenInfo.new(2), {CFrame = targetCFrame})

  tween:Play()
```

Camera.CFrame

`Datatype.CFrame` của `Class.Camera`, xác định vị trí và
hướng của nó trong thế giới 3D.

Phiên bản cũ của thuộc tính `Class.Camera.CFrame|CFrame` mà
hoạt động giống hệt như nó.

Mục này nên được sử dụng trong một `Class.LocalScript` để hoạt động như
mong đợi trực tuyến.

Camera.CoordinateFrame

Thiết lập số độ theo hướng chéo (từ một góc của
viewport đến góc đối diện của nó) mà camera có thể nhìn thấy. Xem
`Class.Camera.FieldOfView|FieldOfView` để biết giải thích tổng quát hơn về
trường nhìn.

Lưu ý rằng `DiagonalFieldOfView` đại diện cho trường nhìn mà
camera có thể nhìn thấy khi render vào khu vực toàn màn hình có thể
bị che khuất bởi các notch hoặc cắt màn hình trên một số thiết bị. Xem
`Class.Camera.ViewportSize|ViewportSize` để biết thêm thông tin.

Camera.DiagonalFieldOfView

Thiết lập góc của trường nhìn chéo của camera.

Thuộc tính `FieldOfView` (FOV) thiết lập số độ theo hướng dọc
mà camera có thể nhìn thấy. Thuộc tính này bị giới hạn giữa `1` và
`120` độ và mặc định là `70`. Các trường nhìn rất thấp hoặc rất cao
không được khuyến nghị vì chúng có thể gây mất phương hướng cho người chơi.

Lưu ý rằng việc tỷ lệ đồng nhất được thực thi, có nghĩa là trường nhìn dọc và ngang
luôn liên quan đến tỷ lệ khung hình của màn hình.

Các sử dụng được đề xuất cho `FieldOfView` bao gồm:

- Giảm FOV để tạo ấn tượng về sự phóng đại, ví dụ khi
  sử dụng ống nhòm.
- Tăng FOV khi người chơi đang "chạy" để tạo ấn tượng về
  sự thiếu kiểm soát.

Lưu ý rằng `FieldOfView` đại diện cho trường nhìn mà camera có thể nhìn thấy khi
render vào khu vực toàn màn hình có thể bị che khuất bởi các notch hoặc cắt màn hình trên một số thiết bị. Xem
`Class.Camera.ViewportSize|ViewportSize` để biết thêm thông tin.

Camera.FieldOfView

Thiết lập góc của trường nhìn dọc của camera.

FOV của camera `Class.Camera.FieldOfView|FieldOfView` (FOV) phải được cập nhật
để phản ánh các thay đổi `Class.Camera.ViewportSize|ViewportSize`. Giá trị của
`FieldOfViewMode` xác định giá trị FOV nào sẽ được giữ nguyên.

Ví dụ, khi thuộc tính này được thiết lập thành `Enum.FieldOfViewMode.Vertical`,
FOV ngang sẽ được cập nhật khi kích thước viewport thay đổi, nhưng FOV dọc sẽ được giữ nguyên. Nếu thuộc tính này được thiết lập thành
`Enum.FieldOfViewMode.Diagonal`, cả FOV ngang và dọc có thể được
thay đổi để giữ cho FOV chéo không thay đổi.

Camera.FieldOfViewMode

Xác định giá trị FOV của `Class.Camera` không thay đổi khi
thay đổi kích thước viewport.

Một số thao tác đồ họa mà engine thực hiện, chẳng hạn như cập nhật
ánh sáng, có thể mất thời gian hoặc công sức tính toán để hoàn thành. Thuộc tính
`Focus` của camera cho engine biết khu vực nào trong không gian 3D cần được ưu tiên
khi thực hiện các thao tác như vậy. Ví dụ, ánh sáng động từ
các đối tượng như `Class.PointLight|PointLights` có thể không được render ở khoảng cách
xa khỏi tiêu điểm.

Các script camera mặc định của Roblox tự động thiết lập `Focus` để theo dõi
`Class.Camera.CameraSubject|CameraSubject` (thường là một `Class.Humanoid`).
Tuy nhiên, `Focus` sẽ **không** tự động cập nhật khi
`Class.Camera.CameraType|CameraType` được thiết lập thành
`Enum.CameraType.Scriptable` hoặc khi các script camera mặc định không
được sử dụng. Trong những trường hợp này, bạn nên cập nhật `Focus` mỗi khung hình, sử dụng
phương pháp `Class.RunService:BindToRenderStep()` với
độ ưu tiên `Enum.RenderPriority.Camera`.

`Focus` không ảnh hưởng đến vị trí hoặc hướng của camera; xem
`Class.Camera.CFrame|CFrame` để biết điều này.

Camera.Focus

Thiết lập khu vực trong không gian 3D được ưu tiên bởi các hệ thống đồ họa của Roblox.

Camera.focus

Chuyển đổi xem camera có tự động theo dõi chuyển động đầu của người
chơi sử dụng thiết bị VR hay không. Khi `true` (mặc định), engine kết hợp
`Class.Camera.CFrame|CFrame` với `Enum.UserCFrame` của đầu người dùng
để render cái nhìn của người chơi với việc theo dõi đầu được tính đến. Cái nhìn sẽ
được render tại `Datatype.CFrame` sau:

```lua
local UserInputService = game:GetService("UserInputService")

local camera = workspace.CurrentCamera

local headCFrame = UserInputService:GetUserCFrame(Enum.UserCFrame.Head)
headCFrame = headCFrame.Rotation + headCFrame.Position * camera.HeadScale

-- Điều này sẽ tương đương với Camera:GetRenderCFrame()
local renderCFrame = camera.CFrame * headCFrame
```
Khuyến nghị **không** vô hiệu hóa thuộc tính này vì các lý do sau:

- Người chơi có thể trải qua chứng say tàu xe nếu không có giải pháp theo dõi đầu tương đương
  được thêm vào.
- Roblox Engine thực hiện tối ưu hóa độ trễ khi `HeadLocked` là
  true.

##### Xem Thêm

- `Class.VRService:GetUserCFrame()` có thể được sử dụng để lấy
  `Datatype.CFrame` của đầu.
- `Class.VRService:RecenterUserHeadCFrame()` được sử dụng để đặt lại đầu về vị trí và hướng hiện tại của thiết bị VR.
- Phương pháp `Class.Camera:GetRenderCFrame()|GetRenderCFrame()` mà
  trả về `Class.Camera.CFrame|CFrame` kết hợp với
  `Datatype.CFrame` của đầu người dùng.

Camera.HeadLocked

Chuyển đổi xem camera có tự động theo dõi chuyển động đầu của người
chơi sử dụng thiết bị VR hay không.

`HeadScale` là tỷ lệ của góc nhìn của người dùng về thế giới khi sử dụng
VR.

Kích thước của 1 stud trong VR là `0.3 mét / HeadScale`, có nghĩa là các giá trị
`HeadScale` lớn hơn sẽ khiến thế giới trông nhỏ hơn từ góc nhìn của người dùng khi sử dụng thiết bị VR. Ví dụ, một phần cao 1 stud
trông có chiều cao 0.6 mét đối với một người chơi VR có `HeadScale` là `0.5`.

Thuộc tính này được điều khiển tự động bởi
`Class.VRService.AutomaticScaling` để căn chỉnh góc nhìn của người chơi với
kích thước của avatar của họ. Nếu bạn dự định kiểm soát `HeadScale` của riêng mình hoặc
sử dụng các nhân vật tùy chỉnh, hãy chuyển `Class.VRService.AutomaticScaling` thành
`Enum.VRScaling.Off`.

Thuộc tính này không nên bị nhầm lẫn với `Class.Humanoid.HeadScale` mà
là một `Class.NumberValue` được gán cho một `Class.Humanoid` để kiểm soát
tỷ lệ của nó.

Camera.HeadScale

Thiết lập tỷ lệ của góc nhìn của người dùng về thế giới khi sử dụng VR.

Thuộc tính `MaxAxisFieldOfView` thiết lập số độ dọc theo trục viewport dài nhất
mà camera có thể nhìn thấy.

Khi trục dài nhất là trục dọc, thuộc tính này sẽ hoạt động
tương tự như thuộc tính `Class.Camera.FieldOfView|FieldOfView`. Đây là
trường hợp chung khi một thiết bị ở chế độ dọc. Trong một
chế độ ngang, trục dài nhất sẽ là trục ngang; trong
trường hợp này, thuộc tính mô tả trường nhìn ngang của
`Class.Camera`.

Camera.MaxAxisFieldOfView

Thiết lập góc của trường nhìn của camera dọc theo trục viewport dài nhất.

Thuộc tính `NearPlaneZ` mô tả khoảng cách mà mặt phẳng cắt gần của camera,
tính bằng studs. Mặt phẳng cắt gần là một mặt phẳng hình học
nằm trước `Class.Camera.CFrame|CFrame` của camera. Bất kỳ thứ gì
ở giữa mặt phẳng này và camera sẽ không được render, tạo ra một cái nhìn cắt khi xem các đối tượng ở khoảng cách rất ngắn. Giá trị của `NearPlaneZ`
thay đổi giữa các nền tảng khác nhau và hiện tại luôn nằm giữa `-0.1`
và `-0.5`.

<img src="/assets/engine-api/classes/Camera/NearPlaneZ.jpg" width="720" alt="Sơ đồ cho thấy cách NearPlaneZ cắt (không render) nội dung 3D giữa mặt phẳng và camera." />

Camera.NearPlaneZ

Mô tả độ lệch âm **Z**, tính bằng studs, của mặt phẳng cắt gần của camera.

Chỉ định khía cạnh nào của `Class.Camera.ViewportSize|ViewportSize` được
kiểm soát bởi `Class.Camera.OrthographicSize|OrthographicSize`.

Ví dụ, khi thuộc tính này được đặt thành
`Enum.OrthographicMode.Vertical`, phép chiếu chính tắc sẽ được mở rộng
để chiều dọc trải dài chính xác
`Class.Camera.OrthographicSize|OrthographicSize` studs, và chiều ngang
sẽ trải dài bao nhiêu studs cần thiết để khớp.

Camera.OrthographicMode

Đặt trục màn hình mà `Class.Camera.OrthographicSize|OrthographicSize` được
áp dụng cho.

`Class.Camera.OrthographicMode|OrthographicMode` chọn chiều của
viewport mà bạn muốn kiểm soát.
`Class.Camera.OrthographicSize|OrthographicSize` đặt độ dài trong studs
mà chiều viewport đó trải dài.

Ví dụ, nếu `Class.Camera.OrthographicMode|OrthographicMode` được đặt thành
`Enum.OrthographicMode.MaxAxis`, thì chiều lớn hơn của viewport
sẽ trải dài `Class.Camera.OrthographicSize|OrthographicSize` studs.

Camera.OrthographicSize

Đặt độ dài trong studs của chiều được chọn bởi
`Class.Camera.OrthographicMode|OrthographicMode`.

Đặt thành `Enum.ProjectionType.Perspective` (mặc định) để sử dụng một
camera phối cảnh, nơi các đường song song trong 3D hội tụ trên màn hình và các đối tượng trở nên
nhỏ hơn khi ở xa. Đặt thành `Enum.ProjectionType.Orthographic` để sử dụng
một camera chính tắc, nơi các đường song song vẫn song song và các đối tượng có
cùng kích thước ở bất kỳ khoảng cách nào. Điều này hữu ích cho các trò chơi 2D,
trò chơi isometric, và minimaps.

Camera.ProjectionType

Chọn giữa camera phối cảnh và camera chính tắc.

`ViewportSize` trả về kích thước của khu vực an toàn của thiết bị trên
màn hình hiện tại. Khu vực này là một hình chữ nhật bao gồm khu vực thanh trên
Roblox nhưng không bao gồm bất kỳ notch hoặc cắt màn hình nào của thiết bị. Đơn vị
của `ViewportSize` là đơn vị bù UI của Roblox có thể khác với
pixel hiển thị gốc.

<img src="../../../assets/engine-api/classes/Camera/DeviceSafeAreaVsFullscreen.png" width="840" alt="Màn hình thiết bị di động với cắt cho thấy khu vực an toàn của thiết bị." />

Như đã đề cập ở trên, `ViewportSize` không bằng kích thước khu vực toàn màn hình trên
các màn hình có cắt hoặc notch. Để lấy kích thước khu vực toàn màn hình trên
tất cả các màn hình, bạn có thể truy vấn thuộc tính
`Class.ScreenGui.AbsoluteSize|AbsoluteSize` của một
`Class.ScreenGui` với `Class.ScreenGui.ScreenInsets|ScreenInsets` được đặt thành
`Enum.ScreenInsets.None|None`. Xem `Enum.ScreenInsets` để biết thêm
thông tin về cách các khu vực màn hình được xác định.

Cuối cùng, lưu ý rằng `ViewportSize` không phải là kích thước viewport thực tế mà
camera sử dụng để render (camera render trong khu vực toàn màn hình).
Ngoài ra, các thuộc tính `Class.Camera.FieldOfView|FieldOfView` và
`Class.Camera.DiagonalFieldOfView|DiagonalFieldOfView` dựa trên khu vực toàn màn hình, không phải `ViewportSize`.

##### Cập nhật Camera

Chỉ có `Class.Camera` hiện tại được tham chiếu bởi
`Class.Workspace.CurrentCamera` có `ViewportSize` được cập nhật mỗi khung hình
trong bước `Class.RunService.PreRender|PreRender`. `ViewportSize`
của tất cả các camera khác trong trải nghiệm của bạn sẽ không được cập nhật, bao gồm cả những camera
được sử dụng cho `Class.ViewportFrame|ViewportFrames`.

Camera.ViewportSize

Kích thước của khu vực an toàn của thiết bị trên một client Roblox.

Góc nhìn và kích thước chính tắc được chỉ định cho một trục của
viewport, hoặc chiều ngang hoặc chiều dọc. Thông thường, trục còn lại
tự động điều chỉnh để giữ cho pixel vuông. Điều này cho phép bạn kéo dài
trục còn lại để pixel không vuông, với tỷ lệ lên đến 2:1.
Điều này có thể được hoạt hình để làm cho cái nhìn cảm thấy không hoàn toàn đúng, chẳng hạn như khi
bị choáng.

Điều này hoạt động cho cả camera chính tắc và camera phối cảnh.

Camera.ViewStretch

Kéo dài trục của cái nhìn không bị gắn bởi
`Class.Camera.FieldOfViewMode|FieldOfViewMode` hoặc
`Class.Camera.OrthographicMode|OrthographicMode` hiện tại.

Thuộc tính này chuyển đổi việc áp dụng độ nghiêng và lăn từ thuộc tính
`Class.Camera.CFrame|CFrame` trong khi người chơi đang sử dụng thiết bị VR.

Để ngăn ngừa say tàu xe, đường chân trời nên giữ ở mức độ. Nghiêng và
lăn cái nhìn của người chơi trong khi sử dụng thiết bị VR có thể gây ra sự ngắt kết nối
giữa không gian vật lý của người chơi và không gian ảo mà họ đang
xem. Thay đổi hướng xuống rõ ràng có thể khiến người chơi mất thăng bằng hoặc cảm thấy chóng mặt.

Vì những lý do này, thường thì nên để thuộc tính này\không được kích hoạt, trừ khi bạn đã thử nghiệm kỹ lưỡng trải nghiệm của mình cho những
tác động này. Ngay cả khi độ nghiêng và lăn được kích hoạt, bạn có thể muốn đảm bảo rằng người chơi luôn có một khung tham chiếu ổn định, chẳng hạn như bên trong một
phương tiện hoặc một sàn có thể giúp người chơi định vị trong không gian vật lý của họ.

Camera.VRTiltAndRollEnabled

Chuyển đổi việc áp dụng độ nghiêng và lăn từ thuộc tính
`Class.Camera.CFrame|CFrame` trong khi người chơi đang sử dụng thiết bị VR.

Một lớp định nghĩa một cái nhìn của thế giới 3D.

Một `Class.PVInstance` là một lớp trừu tượng không thể được tạo ra. Nó là
cơ sở cho tất cả các đối tượng có vị trí vật lý trong thế giới.

Mẫu mã này là một kịch bản dịch chuyển đơn giản di chuyển nhân vật của bạn
10&nbsp;studs về phía trước theo hướng bạn đang đối diện khi bạn nhấn
phím <kbd>F</kbd>. Nó thực hiện điều này bằng cách lấy pivot hiện tại với
`Class.PVInstance:GetPivot()` và gọi `PVInstance|PivotTo` để di chuyển
nhân vật về phía trước.


Hàm này lấy điểm pivot của một `Class.PVInstance`. Đây thường được sử dụng
với `Class.PVInstance:PivotTo()` để di chuyển một mô hình.

`Class.Model|Models` và `Class.BasePart|BaseParts` đều là
`Class.PVInstance|PVInstances` ("Vị trí Tốc độ Instances") và cả hai
đều có chức năng này.

PVInstance:GetPivot

`Datatype.CFrame` trong không gian thế giới của pivot của thể hiện.


Lấy điểm pivot của một `Class.PVInstance`.

Biến đổi `Class.PVInstance` cùng với tất cả các `Class.PVInstance|PVInstances` con của nó
sao cho điểm pivot hiện nằm ở `Datatype.CFrame` được chỉ định. Đây là hàm chính
mà nên sử dụng để di chuyển `Class.Model|Models` thông qua scripting.

`Class.BasePart|BaseParts` được di chuyển theo cách này bằng cách biến đổi
`Datatype.CFrame` của chúng bằng độ offset cần thiết.
`Class.Model|Models` được di chuyển theo cách này bằng cách biến đổi
`Class.Model.WorldPivot` của chúng bằng độ offset cần thiết.

Lưu ý rằng vì lý do hiệu suất, các sự kiện `Class.Object.Changed` không
được kích hoạt cho `Class.BasePart.Position|Position` và
`Class.BasePart.Orientation|Orientation` của `Class.BasePart|BaseParts`
bị di chuyển theo cách này; chúng chỉ được kích hoạt cho `Datatype.CFrame`.

Khi gọi `Class.PVInstance:PivotTo()|PivotTo` trên `Class.Model|Models`,
các độ offset của các phần và mô hình con được lưu trữ, sao cho
các cuộc gọi sau đó đến `Class.PVInstance:PivotTo()|PivotTo` trên cùng một mô hình
không tích lũy độ trôi điểm nổi giữa các phần tạo nên mô hình.

`Class.Model|Models` và `Class.BasePart|BaseParts` đều là
`Class.PVInstance|PVInstances` ("Vị trí Tốc độ Instances") và cả hai
đều có chức năng này.

PVInstance:PivotTo

targetCFrame

`Datatype.CFrame` mà điểm pivot của `Class.PVInstance` nên bằng
sau khi di chuyển nó.

Biến đổi `Class.PVInstance` cùng với tất cả các `Class.PVInstance|PVInstances` con của nó
sao cho điểm pivot hiện nằm ở `Datatype.CFrame` được chỉ định.

PVInstance

Thuộc tính chỉ dành cho biên tập viên, hiển thị trong cửa sổ Thuộc tính Studio dưới dạng **Vị trí
Gốc** và **Hướng Gốc** trong **Biến đổi**. Giá trị của nó là
`Datatype.CFrame` trong không gian thế giới của pivot của thể hiện; đọc nó
trả về cùng một `Datatype.CFrame` như `Class.PVInstance:GetPivot()`. Nó
không có giá trị lưu trữ riêng và luôn phản ánh pivot hiện tại.

Thiết lập nó từ cửa sổ Thuộc tính di chuyển toàn bộ thể hiện để pivot
đến `Datatype.CFrame` mới, giống như
`Class.PVInstance:PivotTo()`. Chỉnh sửa qua cửa sổ Thuộc tính
tạm thời vô hiệu hóa `Class.WeldConstraint|WeldConstraints` với các
đối tượng khác để di chuyển; `PivotTo` không thay đổi các khớp nối.

Không có sẵn cho các kịch bản; sử dụng `Class.PVInstance:GetPivot()` và
`Class.PVInstance:PivotTo()` trong thời gian chạy thay vào đó.


PVInstance.Origin

Thuộc tính chỉ dành cho biên tập viên, đọc và thiết lập `Datatype.CFrame` của thế giới của
pivot của `Class.PVInstance`, di chuyển toàn bộ thể hiện khi thay đổi
từ cửa sổ Thuộc tính Studio.


Thuộc tính chỉ dành cho biên tập viên, hiển thị trong cửa sổ Thuộc tính Studio dưới dạng **Vị trí
Pivot** và **Hướng Pivot** trong **Pivot**. Nó là
`Datatype.CFrame` của pivot tương đối với khung của thể hiện.

Thay đổi nó từ cửa sổ Thuộc tính di chuyển pivot tương đối với
thể hiện trong khi giữ nguyên thể hiện, không giống như `Origin`, di chuyển
toàn bộ thể hiện. Đối với `Class.BasePart`, độ lệch mặc định là
`Datatype.CFrame` danh tính, vì vậy pivot trùng với trung tâm của phần.
Đối với `Class.Model`, thuộc tính này chỉ xuất hiện khi mô hình có
`Class.Model.PrimaryPart|PrimaryPart`; nó sau đó phản ánh và chỉnh sửa
`Class.BasePart.PivotOffset|PivotOffset` của phần đó, và
`Class.Model:GetPivot()` là bí danh cho pivot của phần chính.

Không có sẵn cho các kịch bản; các kịch bản đọc và ghi tương đương thông qua
lớp cụ thể, chẳng hạn như `Class.BasePart.PivotOffset`.


PVInstance.Pivot Offset

Thuộc tính chỉ dành cho biên tập viên, hiển thị và chỉnh sửa `Datatype.CFrame`
 của pivot tương đối với thể hiện, chỉ di chuyển pivot và giữ nguyên thể hiện.


Lớp trừu tượng cho tất cả các đối tượng có vị trí vật lý trong thế giới.

`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp Roblox
có thể là một phần của cây `Class.DataModel`.

Không thể tạo trực tiếp các đối tượng `Instance` gốc, nhưng hàm khởi tạo đặc biệt
`Datatype.Instance.new()` tạo ra các đối tượng thông qua mã, nhận tên của lớp như một tham số và trả về đối tượng đã tạo.


Minh họa việc phát hiện các thay đổi trong tổ tiên của một thể hiện bằng cách kết nối với sự kiện
`Class.Instance.AncestryChanged`.

Cha của ChangingPart được thiết lập với các giá trị khác nhau theo thời gian. Cha của
phần đó là tổ tiên của phần đó, vì vậy sự kiện `Class.Instance.AncestryChanged` sẽ được kích hoạt
mỗi khi nó thay đổi.

Kích hoạt khi thể hiện này được thay đổi cha hoặc khi bất kỳ tổ tiên nào của
nó được thay đổi cha.

Bạn có thể sử dụng sự kiện này để theo dõi việc xóa một thể hiện trong Studio,
như xóa thủ công trong Explorer hoặc thông qua một plugin. Nếu bạn cần
phát hiện khi một thể hiện bị xóa bằng `Class.Instance:Destroy()`, hãy sử dụng
event `Class.Instance.Destroying` thay thế.


Instance.AncestryChanged

child

Thể hiện có thuộc tính `Class.Instance.Parent|Parent` đã thay đổi,
điều này có thể là thể hiện này hoặc một tổ tiên xa hơn, **không**
nhất thiết là thể hiện mà trình xử lý được kết nối.


parent

Kích hoạt khi thuộc tính `Class.Instance.Parent` của đối tượng này hoặc một
trong các tổ tiên của nó bị thay đổi.


Sự kiện này kích hoạt bất cứ khi nào bất kỳ thuộc tính nào được thay đổi trên
thể hiện, bao gồm khi một thuộc tính được đặt thành `nil`. Tên của thuộc tính
đã thay đổi được truyền đến hàm đã kết nối.

Ví dụ, đoạn mã sau đây kết nối hàm `attributeChanged()` để kích hoạt bất cứ
khi nào một trong các thuộc tính của phần thay đổi:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "đã thay đổi")
end

part.AttributeChanged:Connect(attributeChanged)
```
Xem thêm `Class.Instance:GetAttributeChangedSignal()` trả về một sự kiện kích
hoạt khi một thuộc tính cụ thể đã thay đổi.


Instance.AttributeChanged

attribute

Tên của thuộc tính đã được thay đổi.


Kích hoạt bất cứ khi nào một thuộc tính được thay đổi trên `Class.Instance`.


Đoạn mã này in tên của các đối tượng khi chúng được thêm vào Workspace:


Kích hoạt sau khi một đối tượng được gán làm con của `Class.Instance` này.

Lưu ý, khi sử dụng phương thức này trên client để phát hiện các đối tượng được
tạo bởi server, cần phải sử dụng `Class.Instance:WaitForChild()` khi chỉ mục
các thế hệ của các đối tượng này. Điều này là do đối tượng và các thế hệ của
nó không được đảm bảo sao chép từ server sang client đồng thời. Ví dụ:

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

Workspace.ChildAdded:Connect(function(child)
	-- Sử dụng WaitForChild() vì các thế hệ có thể chưa được sao chép
	local head = child:WaitForChild("Head")
end)
```
Lưu ý, sự kiện này chỉ hoạt động cho các con ngay lập tức của
`Class.Instance`. Để có một sự kiện ghi lại tất cả các thế hệ, hãy sử dụng
`Class.Instance.DescendantAdded`.

Xem thêm `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Thể hiện `Class.Instance` đã được thêm vào.


Kích hoạt sau khi một đối tượng được gán làm con của `Class.Instance` này.


Instance.childAdded

Đoạn mã này in tên của các đối tượng khi chúng bị xóa khỏi
Workspace:


Kích hoạt sau khi một con được xóa khỏi `Class.Instance` này.

Bị xóa đề cập đến khi cha của một đối tượng được thay đổi từ `Class.Instance`
đến một cái gì đó khác ngoài `Class.Instance` này. Lưu ý, sự kiện này cũng
sẽ kích hoạt khi một con bị xóa (sử dụng `Class.Instance:Destroy()`) vì hàm
xóa đặt cha của một đối tượng thành `nil`.

Sự kiện này chỉ hoạt động cho các con ngay lập tức của `Class.Instance`.
Để có một sự kiện ghi lại tất cả các thế hệ, hãy sử dụng
`Class.Instance.DescendantRemoving`.

Xem thêm `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Thể hiện `Class.Instance` đã bị xóa.


Kích hoạt sau khi một con được xóa khỏi `Class.Instance` này.


Ví dụ sau đây sẽ in ra tên của bất kỳ đối tượng nào được thêm vào
Workspace:

Sự kiện này kích hoạt sau khi một thế hệ được thêm vào `Class.Instance`.

Vì nó kích hoạt cho mỗi thế hệ, việc gán một đối tượng vào
`Class.Instance` sẽ kích hoạt sự kiện cho đối tượng này và tất cả các thế hệ
của nó một cách riêng biệt.

Nếu bạn chỉ quan tâm đến **các con trực tiếp** của
`Class.Instance`, hãy sử dụng `Class.Instance.ChildAdded` thay thế.

Xem thêm `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

Kích hoạt sau khi một thế hệ được thêm vào `Class.Instance`.


Instance

`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp Roblox
có thể là một phần của cây `Class.DataModel`.


/reference/engine/classes/ViewportCamera.yaml

Tóm tắt