¿Qué hace spritekit?
SpriteKit es el motor de renderizado predeterminado para juegos 2D en iOS. Es compatible y no está obsoleto, pero su API está congelada desde iOS 12, por lo que todas las llamadas a SpriteKit funcionan en iOS 26 sin comprobaciones #available. La configuración general del proyecto (Modo de Juego, ProMotion, categoría de la app) se encuentra en el skill ios-game-design.
Evita SK3DNode: incorpora SceneKit, que está obsoleto desde iOS 26. Usa el skill realitykit para 3D.
Alojar la escena en SwiftUI
import SwiftUI
import SpriteKit
struct GameView: View {
@State private var scene: GameScene = { // crear una vez; nunca dentro del body
let s = GameScene(size: CGSize(width: 390, height: 844))
s.scaleMode = .resizeFill
s.anchorPoint = CGPoint(x: 0.5, y: 0.5)
return s
}()
@State private var paused = false
var body: some View {
SpriteView(scene: scene, isPaused: paused, preferredFramesPerSecond: 120,
options: [.ignoresSiblingOrder, .shouldCullNonVisibleNodes],
debugOptions: [.showsFPS, .showsNodeCount, .showsDrawCount]) // solo builds de depuración
.ignoresSafeArea()
.statusBarHidden()
.persistentSystemOverlays(.hidden)
}
}
Los valores predeterminados de SpriteView no son adecuados para juegos; debes sobrescribirlos:
preferredFramesPerSecondpor defecto es 60. Pasa 120 y agregaCADisableMinimumFrameDurationOnPhoneal Info.plist, de lo contrario el iPhone se queda a 60 Hz.optionspor defecto es[.shouldCullNonVisibleNodes], por lo que.ignoresSiblingOrderestá desactivado. Actívalo y configurazPositioncuando el orden de dibujo sea importante.
Modos de escala: .aspectFit añade bordes negros, .aspectFill recorta, .resizeFill se ajusta al tamaño de la vista (reorganiza en didChangeSize(_:)). Elige un tamaño de diseño fijo con un modo de aspecto, o .resizeFill con diseño adaptable. Mantén el mundo sin bordes y solo el HUD y los objetivos táctiles insértalos con view.safeAreaInsets, o dibuja el HUD como una superposición de SwiftUI.
Concurrencia en Swift 6
SKNode(y por tantoSKScene) es@MainActor, heredado deUIResponder. Los cierres creados en una escena (SKAction.run,customAction) heredan el actor principal.SKPhysicsContactDelegateno está aislado, por lo que sin un aislamiento predeterminado al actor principalclass GameScene: SKScene, SKPhysicsContactDelegateno compila en Swift 6. Escribe una conformidad aislada que compile en cualquier configuración:SKScene, @MainActor SKPhysicsContactDelegate.- Precarga con las formas asíncronas (
await atlas.preload(),await SKTexture.preload(textures)); las formas con manejador de finalización son@Sendabley advierten si tocan nodos. await node.run(action)se reanuda cuando la acción termina, lo que es adecuado para secuencias cortas. Nunca se reanuda pararepeatForever.- Los nuevos proyectos de Xcode por defecto usan el modo de lenguaje Swift 5; establece explícitamente
SWIFT_VERSION = 6.
Bucle de fotogramas
Orden por fotograma: update(_:) → acciones → didEvaluateActions() → física (las devoluciones de llamada de contacto se disparan aquí) → didSimulatePhysics() → restricciones → didApplyConstraints() → didFinishUpdate() → renderizado.
currentTimees absoluto. Calculadttú mismo y limítalo (por ejemplo a 1/30 s) para que una pausa o un salto nunca teletransporte objetos.- La tasa de fotogramas varía con el Modo de Bajo Consumo y el estado térmico. Escala todo el movimiento por
dt. - Nunca agregues, elimines o remodeles cuerpos físicos dentro de
didBegin/didEnd. Pon en cola el cambio y aplícalo endidSimulatePhysics()o en el siguienteupdate. - El orden de las acciones dentro de un fotograma no está especificado. Lee las posiciones finales en
didEvaluateActions()o más tarde.
Esqueleto de escena
enum Category { static let player: UInt32 = 1 << 0; static let enemy: UInt32 = 1 << 1; static let wall: UInt32 = 1 << 2 }
final class GameScene: SKScene, @MainActor SKPhysicsContactDelegate {
private var lastTime: TimeInterval = 0
private let cam = SKCameraNode()
private let player = SKSpriteNode(imageNamed: "player")
private var pendingRemovals: [SKNode] = []
override func didMove(to view: SKView) {
physicsWorld.contactDelegate = self // se mantiene sin retener: la escena debe permanecer viva
addChild(cam); camera = cam // los hijos de la cámara forman un HUD fijo en pantalla
let body = SKPhysicsBody(circleOfRadius: 12)
body.categoryBitMask = Category.player
body.collisionBitMask = Category.wall
body.contactTestBitMask = Category.enemy // por defecto 0: sin llamadas a didBegin
player.physicsBody = body
addChild(player)
}
override func update(_ currentTime: TimeInterval) {
let dt = lastTime == 0 ? 0 : min(currentTime - lastTime, 1.0 / 30.0)
lastTime = currentTime
step(dt)
cam.position = player.position
}
override func didSimulatePhysics() { // punto seguro para mutar física
pendingRemovals.forEach { $0.removeFromParent() }
pendingRemovals.removeAll()
}
func didBegin(_ contact: SKPhysicsContact) { // solo registrar; nunca mutar aquí
let a = contact.bodyA, b = contact.bodyB
guard a.categoryBitMask | b.categoryBitMask == Category.player | Category.enemy,
let enemy = (a.categoryBitMask == Category.enemy ? a : b).node else { return }
pendingRemovals.append(enemy)
}
private func step(_ dt: TimeInterval) { /* lógica del juego escalada por dt */ }
}
Componentes básicos
| Necesidad | Usa |
|---|---|
| Cámara, HUD | SKCameraNode; nodos del HUD como hijos de la cámara |
| Interpolaciones, easing | SKAction con timingMode o una timingFunction personalizada |
| Animación de sprites | SKAction.animate(with:timePerFrame:) sobre texturas de atlas |
| Física | SKPhysicsBody (círculo/rectángulo más económico), máscaras establecidas explícitamente, usesPreciseCollisionDetection para cuerpos pequeños y rápidos |
| Niveles con cuadrícula | SKTileMapNode + SKTileSet; las teselas no son nodos, por lo que construye la colisión por separado |
| Texturas | Atlas de Sprites en el catálogo de activos, SKTextureAtlas(named:); precarga antes del juego |
| Arte pixelado | texture.filteringMode = .nearest en cada textura, incluyendo cada fotograma del atlas |
| Partículas | Archivos de emisor .sks, SKEmitterNode(fileNamed:); configura targetNode = scene para estelas |
| Shaders, luces, filtros, deformaciones | Lee references/effects.md |
| Sonido de un solo disparo | SKAction.playSoundFileNamed; para algo más usa el skill game-audio-engine |
| Integración con Metal | SKRenderer dibuja una escena dentro de tu propio pase de Metal |
Rendimiento
- Agrupación: los nodos que comparten una textura o atlas se dibujan en una sola llamada. Los atlas mixtos y los nodos superpuestos en diferentes
zPositiondividen los lotes. ObservashowsDrawCount. - Elimina nodos fuera de pantalla con
removeFromParent(); el recorte aún visita cada nodo en cada fotograma. - Costosos, úsalos con moderación:
SKEffectNodeconCIFilter,SKCropNode, muchosSKShapeNodes, unSKShaderpor sprite, y cambios en el código fuente del shader en tiempo de ejecución (cada uno se recompila). SKShapeNodees para dibujo de depuración. Hornea una forma una vez conview.texture(from:)y dibuja sprites.- Perfila en un dispositivo con la plantilla Game Performance de Instruments y el HUD de Rendimiento Metal (Scheme > Run > Diagnostics > Show Graphics Overview).
Trampas
contactTestBitMaskpor defecto es 0, mientras quecategoryBitMaskycollisionBitMaskpor defecto son todos los bits. Configura los tres para cada cuerpo.UIScreen.mainestá obsoleto en iOS 26. Lee la tasa de refresco deview.window?.windowScene?.screen.maximumFramesPerSecond.- El código fuente de
SKShaderes GLSL ES, no Metal Shading Language. physicsWorld.contactDelegateno se retiene.- Con
.ignoresSiblingOrder, los nodos con el mismozPositionse dibujan en orden arbitrario.
Skills relacionados
Entrada y hápticos: game-controller. Sonido: game-audio-engine. Apariencia, paleta y jugosidad: game-art-direction. Diseño de cuadrícula y salas: game-level-design.