SceneKit: какво е, 3D сцени и граф на сцената

Какво е SceneKit?

SceneKit — е рамка за 3D графика, която е част от SDK на Apple и беше представена в iOS 8 (2014). SceneKit предоставя напълно скриптово API, работещо върху Metal и OpenGL, за създаване на интерактивни 3D сцени. Рамката поддържа импорт на модели във формати Collada (DAE), Alembic (ABC), USD и GLTF чрез Model I/O.

За разлика от ниско ниво API (Metal, Vulkan), SceneKit поема управлението на рендерирането, осветлението и физиката. Разработчикът описва сцената декларативно: добавя възли, задава материали и анимации. SceneKit автоматично оптимизира геометрията, обединява draw calls и управлява LOD, когато е необходимо.

SceneKit може да работи заедно с ARKit за показване на 3D обекти в реалния свят, както и с Core ML за машинно зрение и анализ на сцена. Според Apple (2025), най-новата версия на SceneKit използва само Metal API с поддръжка на Metal 3 и GPU Family 9 на чипове Apple Silicon.

История на SceneKit

SceneKit се появи на macOS през 2012 г. като част от OS X Mountain Lion и първоначално използваше OpenGL за рендериране. С пускането на iOS 8 рамката стана достъпна на мобилни устройства. Версия SceneKit 2.0 (iOS 10) добави поддръжка за PBR материали, HDR осветление и интеграция с Model I/O за импорт на модели.

В iOS 12 SceneKit напълно премина към Metal. iOS 15 въведе поддръжка за USDZ формат и AR Quick Look. С iOS 18 (2024), SceneKit получи хардуерно ускорение на проследяване на лъчи на устройства с чип A17 Pro и M4, позволявайки реалистични сенки и отражения в реално време на мобилни устройства.

Архитектура на SceneKit: граф на сцената и възли

Архитектурата на SceneKit се основава на графа на сцената, където SCNScene е кореновият елемент, съдържащ йерархията SCNNode. Всеки възел има дъщерни възли и може да съдържа геометрия, камера, светлина или физическо тяло. Позицията на възела се определя чрез SCNVector3 (x, y, z) в ляво ориентирана координатна система.

SCNScene — коренов контейнер

SCNScene съдържа цялото състояние на 3D света: кореновия възел rootNode, настройки на фона (background), източници на светлина и физическия свят (SCNPhysicsWorld). Сцената може да бъде заредена от .scn файл (SceneKit Scene Format) или създадена програмно. Форматът .scn е отворен и базиран на JSON.

import SceneKit
 
let scene = SCNScene()
scene.background.contents = UIColor.darkGray
 
// Създаване на камера
let cameraNode = SCNNode()
cameraNode.camera = SCNCamera()
cameraNode.position = SCNVector3(0, 5, 10)
scene.rootNode.addChildNode(cameraNode)
 
// Създаване на куб с физика
let box = SCNBox(width: 2, height: 2, length: 2, chamferRadius: 0)
let boxNode = SCNNode(geometry: box)
boxNode.physicsBody = SCNPhysicsBody(type: SCNPhysicsBodyType.dynamic,
    shape: SCNPhysicsShape(geometry: box))
scene.rootNode.addChildNode(boxNode)

Класът SCNCamera конфигурира перспективна или ортографска проекция. Параметри: fieldOfView (ъгъл на видимост, по подразбиране 45°), zNear/zFar (близка/далечна равнина на отсичане). SceneKit автоматично управлява проекционната матрица на базата на тези параметри и съотношението на страните на екрана.

SCNNode — възли на сцената

SCNNode свързва геометрия, трансформация и физическо тяло. Възлите могат да бъдат празни (контейнери за други възли) или да съдържат геометрия чрез свойството geometry. Всеки възел има име (name) за програмно търсене и може да бъде анимиран чрез CAAnimation или предварително дефинирани SCNTransaction.

Трансформацията на възела се определя чрез свойствата position (SCNVector3), rotation (SCNVector4) и scale (SCNVector3). За сложни трансформации се използва свойството transform (SCNMatrix4). Също така са налични pivot — изместване на центъра на трансформация и worldPosition — абсолютна позиция в световното пространство, независима от йерархията.

SCNView — рендериране

SCNView — UIView за показване на SCNScene. Свойството allowsCameraControl активира потребителско управление на камерата чрез жестове (преместване, завъртане, мащабиране). За отстраняване на грешки са налични showsStatistics (FPS, draw calls, полигони) и debugOptions (wireframe, bounding boxes).

В SwiftUI, SceneKit се вгражда чрез SceneView, което обвива SCNView и поддържа обвързвания към параметри на сцената. Според Apple (2025), SceneView използва същия Metal рендер като SCNView, без допълнително натоварване за моста между SwiftUI и UIKit.

Материали, осветление и физика в SceneKit

SCNMaterial определя как повърхността на геометрията взаимодейства със светлината. SceneKit поддържа PBR (Physically Based Rendering) чрез SCNMaterial.LightingModel.physicallyBased, който използва параметрите roughness, metalness, albedo и normal. PBR материалите изглеждат реалистично при всяко осветление без ръчна настройка на блясък.

SCNMaterial и текстури

SCNMaterial има няколко канала: diffuse (цвят/текстура), specular (огледален блясък), normal (карта на нормалите), emission (излъчване), roughness (грапавост) и metalness (металичност). Всеки канал може да съдържа UIColor, UIImage, CALayer или SKScene за анимирани текстури.

// PBR материал за 3D обект
let sphere = SCNSphere(radius: 1.5)
let material = SCNMaterial()
material.lightingModel = SCNMaterial.LightingModel.physicallyBased
material.diffuse.contents = UIColor.orange
material.roughness.contents = 0.3
material.metalness.contents = 0.8
sphere.materials = [material]
 
let sphereNode = SCNNode(geometry: sphere)
sphereNode.position = SCNVector3(0, 2, -5)

Параметърът roughness 0.3 с metalness 0.8 създава материал, наподобяващ полиран метал с матово покритие. За диелектрици (дърво, пластмаса) metalness се задава на 0, а за метали — близо до 1.0. PBR материалите автоматично се адаптират към HDR осветлението на сцената.

Осветление в SceneKit

SCNLight поддържа няколко типа източници на светлина: omni (точков), directional (насочен), spot (прожектор), ambient (околен) и area (повърхностен). Всеки източник има интензитет (intensity), цвят (color) и може да хвърля сенки (castsShadow). SceneKit автоматично управлява сенките чрез shadow maps.

SceneKit поддържа HDR осветление с тонална компресия (tone mapping). Свойството wantsHDR на SCNView активира разширен динамичен обхват. Атрибути на камерата: whitePoint, adaptativeLuminance и exposure адаптират изображението към яркостта на сцената, създавайки ефект на фотографска експозиция.

Физика SCNPhysicsBody

SCNPhysicsBody симулира физика на твърди тела: гравитация, колизии и триене. Типове тела: .static (неподвижно), .dynamic (под въздействие на сили) и .kinematic (програмно управлявано). Формата на тялото се определя чрез SCNPhysicsShape, която може да бъде базирана на геометрията на възела или на опростена форма (box, sphere, concave polyhedron).

SCNPhysicsWorld управлява глобалната физика на сцената: гравитация (gravity), скорост на симулация (speed) и откриване на колизии чрез делегата SCNPhysicsContactDelegate. SceneKit поддържа физически стави (SCNPhysicsHingeJoint, SCNPhysicsBallJoint, SCNPhysicsSliderJoint) за създаване на механизми и свързани обекти.

Разработка на 3D сцени в SceneKit

Разработката в SceneKit обикновено започва със зареждане на 3D модел чрез Model I/O или .scn файл. Редакторът на сцени в Xcode (Scene Editor) позволява визуално поставяне на обекти, конфигуриране на материали и осветление без код. .scn файловете се записват в JSON формат и поддържат контрол на версиите чрез git.

Импорт на 3D модели

Model I/O (ModelIO.framework) — мощен инструмент за импорт, експорт и обработка на 3D модели. SceneKit може директно да използва MDLAsset обекти, превръщайки ги в SCNScene. Поддържани формати: USD, USDZ, OBJ, STL, PLY, Collada (DAE) и Alembic (ABC). Модели с анимации (скелетна анимация, морфинг) също се импортират.

// Зареждане на 3D модел чрез Model I/O
import ModelIO
 
let url = Bundle.main.url(forResource: "robot",
    withExtension: "usdz")!
let asset = MDLAsset(url: url)
let scene = SCNScene(mdlAsset: asset)
 
// Търсене на възли по име за конфигуриране
if let robot = scene.rootNode.childNode(
    withName: "RobotArmature", recursively: true
) {
    robot.position = SCNVector3(0, 0, -3)
}

След импорт, моделът може да бъде анимиран чрез CAAnimation, копиран от MDLAnimation, или чрез SCNTransaction за плавни промени на свойствата. Анимационната система на SceneKit поддържа смесване на анимации и синхронизация с физиката за създаване на реалистични движения.

Анимация и транзакции

SCNTransaction позволява групиране на промени на параметри на сцената в анимационен блок с определена продължителност. Методите begin() и commit() обграждат промените, а duration задава продължителността на анимацията. Вложените транзакции се поддържат за паралелни анимации с различна продължителност. Completion блокът се изпълнява след завършване на анимацията.

За скелетна анимация, SceneKit поддържа SCNAnimation и SCNMorpher за blend-shape (morph targets). Всяка анимация може да бъде повторена, мащабирана във времето и смесена с други анимации чрез additive blending. Според Apple (2025), SceneKit поддържа до 4 едновременно смесени анимации на един скелет.

Системи за частици SCNParticleSystem

SCNParticleSystem — вградена система за частици за създаване на ефекти: дим, огън, дъжд и искри. Частиците могат да бъдат излъчени от точка, сфера, куб или повърхност на геометрия. Параметри: birthRate, particleLifeSpan, speed, acceleration и colorOverLife. Системите за частици работят на GPU за максимална производителност.

Според Apple (2025), SCNParticleSystem поддържа до 100 хиляди частици с 60 FPS на устройства с A16+. Частиците могат да реагират на колизии с физически тела на сцената. За сложни ефекти, няколко системи за частици с различни параметри могат да бъдат комбинирани и привързани към движещи се възли.

SceneKit и ARKit: разширена реалност

SceneKit е предпочитаната високо ниво рамка за ARKit приложения. ARSCNView разширява SCNView и автоматично синхронизира виртуалния 3D свят с реалната среда. Анализ на изображение, откриване на равнини и проследяване на лице се извършват от ARKit, а рендерирането от SceneKit.

ARSCNView и ARAnchor

ARSCNView поддържа всички функции на SCNView, но замества камерата на сцената с реалната камера на устройството. ARKit анализира видео от камерата и създава ARAnchor, които SceneKit превръща в SCNNode. Сесията на ARKit се управлява чрез свойството session, което се конфигурира с конфигурация (ARWorldTrackingConfiguration, ARFaceTrackingConfiguration).

import ARKit
 
class ARViewController: UIViewController,
    ARSessionDelegate {
    let sceneView = ARSCNView()
     
    override func viewDidLoad() {
        super.viewDidLoad()
        sceneView.session.run(
            ARWorldTrackingConfiguration()
        )
        sceneView.autoenablesDefaultLighting = true
        sceneView.delegate = self
    }
}

Свойството autoenablesDefaultLighting добавя вградено осветление, съответстващо на реалната среда. ARKit 6 (iOS 18) поддържа Location Anchors за прикрепяне на 3D обекти към географски координати и Room Tracking за картографиране на вътрешни пространства с детайлност до мебели.

Откриване на равнини и поставяне на обекти

ARKit открива хоризонтални и вертикални равнини (подове, маси, стени) чрез делегата didAdd/didUpdate/didRemove anchor. Възелът на SceneKit, свързан с ARPlaneAnchor, автоматично проследява позицията на равнината в реално време. За поставяне на обекти се използва методът hitTest на ARSCNView или raycastQuery.

Според Apple (2025), максималното разстояние за проследяване на ARKit на A17 Pro е 50 метра при осветеност от 10 лукса. SceneKit + ARKit осигуряват крайно закъснение (motion-to-photon) под 20 ms, което е критично за AR игри и индустриални приложения с наслагване на 3D инструкции върху реално оборудване.