SCNSceneKit相机适配与场景背景图比例调整问题求助

嘿，这两个SceneKit的坑我之前也踩过！给你拆解下针对性的解决方案：

一、文本节点与框架节点无法适配屏幕的问题 #

你试过zFar、相机位置、缩放都没用？那咱们换几个核心思路试试：

1. 给节点加Billboard约束，确保始终正对相机 #

很多适配问题其实是节点视角偏移导致的——比如文本/框架歪了，看起来就像没适配。给节点加个Billboard约束，让它死死对着相机，就能避免视角偏差：

let billboardConstraint = SCNBillboardConstraint()
// 纯2D场景可以设为.all，允许Y轴旋转的场景设为.Y即可
billboardConstraint.freeAxes = .Y
yourTextNode.constraints = [billboardConstraint]
yourFrameNode.constraints = [billboardConstraint]

2. 改用正交相机替代透视相机 #

如果你的场景是偏UI类的2D场景，透视相机的近大远小会把适配逻辑搅乱。换成正交相机，适配起来直观太多：

let camera = SCNCamera()
camera.usesOrthographicProjection = true
// 根据屏幕尺寸调整scale，这里取宽高中较小值的一半，按需调整
camera.orthographicScale = min(sceneView.frame.width, sceneView.frame.height) / 2
camera.zNear = 0.1
camera.zFar = 1000

let cameraNode = SCNNode()
cameraNode.camera = camera
cameraNode.position = SCNVector3(0, 0, 50) // 正交相机不用纠结z位置，scale才是关键
sceneView.scene?.rootNode.addChildNode(cameraNode)

3. 用UIKit渲染文本转纹理，替代SCNText #

SCNText的适配一直是个麻烦事，不如用UILabel渲染成图片，再贴到SCNPlane上，尺寸控制完全和UIKit一致：

// 1. 创建UILabel并设置文本属性
let label = UILabel(frame: CGRect(x: 0, y: 0, width: 200, height: 50))
label.text = "你的目标文本"
label.font = UIFont.systemFont(ofSize: 24)
label.textColor = .white
label.backgroundColor = .clear
label.sizeToFit()

// 2. 把Label渲染成UIImage
UIGraphicsBeginImageContextWithOptions(label.bounds.size, false, UIScreen.main.scale)
label.drawHierarchy(in: label.bounds, afterScreenUpdates: true)
let textImage = UIGraphicsGetImageFromCurrentImageContext()!
UIGraphicsEndImageContext()

// 3. 创建SCNPlane并设置材质（除以100是因为SceneKit单位和UIKit不同，按需调整）
let textPlane = SCNPlane(width: label.bounds.width / 100, height: label.bounds.height / 100)
let material = SCNMaterial()
material.contents = textImage
textPlane.materials = [material]

let textNode = SCNNode(geometry: textPlane)
sceneView.scene?.rootNode.addChildNode(textNode)

4. 监听屏幕尺寸变化，动态调整节点 #

在viewDidLayoutSubviews里重新计算节点的缩放或位置，确保适配屏幕旋转/尺寸变化：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    // 调整文本节点缩放匹配屏幕宽高比
    let screenAspect = sceneView.frame.width / sceneView.frame.height
    yourTextNode.scale = SCNVector3(screenAspect, 1, 1)
    
    // 同步更新正交相机的scale
    if let camera = sceneView.pointOfView?.camera, camera.usesOrthographicProjection {
        camera.orthographicScale = min(sceneView.frame.width, sceneView.frame.height) / 2
    }
}

二、背景图无法保持正确比例的问题 #

直接用scene.background.contents确实很难控制比例，最优解是在相机前放一个全屏背景板节点，完全掌控图片拉伸模式：

1. 创建背景板节点并设置材质 #

func setupBackground(with image: UIImage) {
    // 1. 计算图片与屏幕的宽高比
    let imageAspect = image.size.width / image.size.height
    let screenAspect = sceneView.frame.width / sceneView.frame.height
    
    // 2. 创建SCNPlane，尺寸匹配图片比例避免拉伸
    var planeWidth: CGFloat = 100
    var planeHeight: CGFloat = planeWidth / imageAspect
    // 如果屏幕更宽，调整高度适配屏幕
    if screenAspect > imageAspect {
        planeHeight = 100
        planeWidth = planeHeight * imageAspect
    }
    
    let backgroundPlane = SCNPlane(width: planeWidth, height: planeHeight)
    let material = SCNMaterial()
    material.contents = image
    // 选择拉伸模式：.resizeAspect保持比例，.resizeAspectFill填充裁剪
    material.contentsGravity = .resizeAspect
    backgroundPlane.materials = [material]
    
    // 3. 把背景板放在相机正前方，避免遮挡内容
    let backgroundNode = SCNNode(geometry: backgroundPlane)
    backgroundNode.position = SCNVector3(0, 0, (sceneView.pointOfView?.camera?.zFar ?? 1000) - 0.1)
    // 添加Billboard约束确保始终面向相机
    let billboardConstraint = SCNBillboardConstraint()
    billboardConstraint.freeAxes = .all
    backgroundNode.constraints = [billboardConstraint]
    
    // 4. 插入到根节点最底层，保证不会遮挡其他内容
    sceneView.scene?.rootNode.insertChildNode(backgroundNode, at: 0)
}

2. 监听屏幕变化，更新背景板尺寸 #

同样在viewDidLayoutSubviews里调整背景板，适配屏幕旋转：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    // 找到背景节点并更新尺寸
    guard let backgroundNode = sceneView.scene?.rootNode.childNodes.first(where: { $0.geometry is SCNPlane }),
          let plane = backgroundNode.geometry as? SCNPlane,
          let image = plane.materials.first?.contents as? UIImage else { return }
    
    let imageAspect = image.size.width / image.size.height
    let screenAspect = sceneView.frame.width / sceneView.frame.height
    
    if screenAspect > imageAspect {
        plane.height = 100
        plane.width = plane.height * imageAspect
    } else {
        plane.width = 100
        plane.height = plane.width / imageAspect
    }
}

内容的提问来源于stack exchange，提问作者Bilal Şimşek