7. 相机对象

相机¶

VRP相机主要功能是用来浏览场景，分为默认相机，跟随相机，地图相机和旋转相机。

跟随相机：在VR场景中，跟随相机是用来通过相机跟随目标物体（如车、人等）的移动来实现浏览场景。跟随相机的特点是相机和相机的目标点随着目标物体一起移动。

地图相机：在浏览VR场景时，地图相机可为当前场景的整个外貌提供一个全局鸟瞰视图。

旋转相机：在浏览VR场景时，有时候会需要锁定一个目标建筑物然后围绕这个建筑物体对其进行环绕浏览。这时，用户就需要在场景中创建一个旋转相机，利用旋转相机对建筑物进行环绕浏览。

属性列表¶

属性	属性名	类型	默认值/可选值	说明
启用为主相机	main	boolean	true、false	启用默认/跟随/地图/旋转相机为主相机。
启用	enabled	boolean	true、false	启用默认/跟随/地图/旋转相机。
视角	fieldOfView	number		相机观察的视角的大小。视角越大，能看到的视野也越大，对应的焦距也越短。
近截面	nearClipPlane	number		相机观察范围内最近的截面。
远截面	farClipPlane	number		相机观察范围内最远的截面。
旋转物体	target	string		可选择需要围绕其进行环绕浏览的物体。
旋转速度	rotationSpeed	number		可设置相机旋转速度。
旋转轴	rotationAxis	number	0、1、2	可选择旋转轴的方向。 0=X轴；1=Y轴；2=Z轴。

示例代码¶

    // 是否启用默认相机为主相机|main
    camera.main = true;
    // 修改视角|fieldOfView
    camera.fieldOfView = 150;
    // 修改近截面|nearClipPlane
    camera.nearClipPlane = 0.0005;
    // 修改远截面|farClipPlane
    camera.farClipPlane = 1000;

示例案例¶

    // 1-默认相机   
    defaultCamera_Demo() {
        // 获取默认相机
        let camera_Actor = gVrpManager.Scene().FindActor("Camera");
        // 获取默认相机组件
        let camera = camera_Actor.GetComponent("CameraComponent");
        // 是否启用默认相机为主相机|main
        camera.main = true;
        // 修改默认相机属性的位置/旋转/缩放
        camera_Actor.localPosition = { x: 0, y: 0, z: -15 };
        camera_Actor.localEulerAngles = { x: 0, y: 20, z: 10 };
        camera_Actor.localScale = { x: 1, y: 1, z: 1 };
        // 修改视角|fieldOfView
        camera.fieldOfView = 150;
        // 修改近截面|nearClipPlane
        camera.nearClipPlane = 0.0005;
        // 修改远截面|farClipPlane
        camera.farClipPlane = 1000;
    }

    // 2-跟随相机
    followCamera_Demo() {
        // 获取跟随相机
        let followCamera_Actor = gVrpManager.Scene().FindActor("Follow Camera");
        // 获取跟随相机组件
        let followCamera = followCamera_Actor.GetComponent("FollowCamera");
        // 修改跟随相机属性的位置/旋转/缩放
        followCamera_Actor.localPosition = { x: 0, y: 0, z: -9 };
        followCamera_Actor.localEulerAngles = { x: 20, y: 1, z: 0 };
        followCamera_Actor.localScale = { x: 1, y: 1, z: 1 };
        // 获取默认相机组件
        let defaultFollowCamera = followCamera_Actor.GetComponent("CameraComponent");
        // 是否启用跟随相机为主相机|main
        defaultFollowCamera.main = true;
        // 是否启用跟随相机|enabled
        followCamera.enabled = true;
        // 选择跟随物体|target  
        followCamera.target = "Box";
    }

    // 3-旋转相机
    rotateCamera_Demo() {
        // 获取旋转相机
        let rotateCamera_Actor = gVrpManager.Scene().FindActor("Rotate Camera");
        // 获取旋转相机组件
        let rotateCamera = rotateCamera_Actor.GetComponent("RotateCamera");
        // 获取默认相机组件
        let defaultRotateCamera = rotateCamera_Actor.GetComponent("CameraComponent");
        // 修改相机属性的位置/旋转/缩放
        rotateCamera_Actor.localPosition = { x: 0, y: -0.2, z: 0 };
        rotateCamera_Actor.localEulerAngles = { x: 10, y: 0, z: 0 };
        rotateCamera_Actor.localScale = { x: 1, y: 1, z: 1 };
        // 是否启用旋转相机为主相机|main
        defaultRotateCamera.main = true;
        // 选择旋转物体|target  
        rotateCamera.target = "Box";
        // 修改旋转速度|rotationSpeed
        rotateCamera.rotationSpeed = 13;
        // 修改旋转轴|rotationAxis 
        rotateCamera.rotationAxis = 0;
    }