O que spritekit faz?
SpriteKit é o renderizador padrão para jogos 2D iOS. Ele é suportado e não obsoleto, mas sua API está congelada desde o iOS 12, portanto toda chamada SpriteKit funciona no iOS 26 sem verificações #available. Configurações de todo o projeto (Game Mode, ProMotion, categoria do aplicativo) estão na habilidade ios-game-design.
Evite SK3DNode: ele incorpora o SceneKit, que está obsoleto desde o iOS 26. Use a habilidade realitykit para 3D.
Hospedar a cena em SwiftUI
import SwiftUI
import SpriteKit
struct GameView: View {
@State private var scene: GameScene = { // cria uma vez; nunca dentro do 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]) // apenas builds de depuração
.ignoresSafeArea()
.statusBarHidden()
.persistentSystemOverlays(.hidden)
}
}
Os padrões de SpriteView estão errados para jogos; sobrescreva-os:
preferredFramesPerSecondpadrão é 60. Passe 120 e adicioneCADisableMinimumFrameDurationOnPhoneao Info.plist, caso contrário o iPhone permanece em 60 Hz.optionspadrão é[.shouldCullNonVisibleNodes], então.ignoresSiblingOrderestá desligado. Ligue-o e definazPositionsempre que a ordem de desenho for importante.
Modos de escala: .aspectFit letterbox, .aspectFill corta, .resizeFill acompanha o tamanho da view (reorganize o layout em didChangeSize(_:)). Escolha um tamanho de design fixo com um modo de aspecto, ou .resizeFill com layout adaptativo. Mantenha o mundo sem bordas e insira apenas HUD e alvos de toque com view.safeAreaInsets, ou desenhe o HUD como uma sobreposição SwiftUI.
Concorrência Swift 6
SKNode(e portantoSKScene) é@MainActor, herdado deUIResponder. Closures criadas em uma cena (SKAction.run,customAction) herdam o main actor.SKPhysicsContactDelegateé não isolado, então sem isolamento padrão de main actorclass GameScene: SKScene, SKPhysicsContactDelegatefalha ao compilar em Swift 6. Escreva uma conformidade isolada, que compila em todas as configurações:SKScene, @MainActor SKPhysicsContactDelegate.- Pré-carregue com as formas assíncronas (
await atlas.preload(),await SKTexture.preload(textures)); as formas com manipulador de conclusão são@Sendablee emitem aviso quando tocam em nós. await node.run(action)retoma quando a ação termina, o que é adequado para sequências curtas. Nunca retorna pararepeatForever.- Novos projetos Xcode usam modo de linguagem Swift 5 por padrão; defina
SWIFT_VERSION = 6explicitamente.
Loop de quadros
Ordem por quadro: update(_:) → ações → didEvaluateActions() → física (callbacks de contato disparam aqui) → didSimulatePhysics() → constraints → didApplyConstraints() → didFinishUpdate() → renderizar.
currentTimeé absoluto. Calculedtvocê mesmo e limite-o (por exemplo a 1/30 s) para que uma pausa ou travamento nunca teletransporte objetos.- A taxa de quadros varia com o Modo de Baixo Consumo e estado térmico. Escale todo movimento por
dt. - Nunca adicione, remova ou reformate corpos de física dentro de
didBegin/didEnd. Enfileire a mudança e aplique-a emdidSimulatePhysics()ou no próximoupdate. - A ordem das ações dentro de um quadro é não especificada. Leia as posições finais em
didEvaluateActions()ou depois.
Esqueleto de cena
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 // mantido não retido: a cena deve permanecer viva
addChild(cam); camera = cam // filhos de cam formam um HUD fixo na tela
let body = SKPhysicsBody(circleOfRadius: 12)
body.categoryBitMask = Category.player
body.collisionBitMask = Category.wall
body.contactTestBitMask = Category.enemy // padrão 0: nenhuma chamada 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() { // ponto seguro para mutar física
pendingRemovals.forEach { $0.removeFromParent() }
pendingRemovals.removeAll()
}
func didBegin(_ contact: SKPhysicsContact) { // apenas registra; nunca muta aqui
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 do jogo escalada por dt */ }
}
Blocos de construção
| Necessidade | Use |
|---|---|
| Câmera, HUD | SKCameraNode; nós HUD como filhos da câmera |
| Interpolações, easing | SKAction com timingMode ou uma timingFunction personalizada |
| Animação de sprite | SKAction.animate(with:timePerFrame:) sobre texturas de atlas |
| Física | SKPhysicsBody (círculo/retângulo mais barato), máscaras definidas explicitamente, usesPreciseCollisionDetection para corpos pequenos e rápidos |
| Níveis em grade | SKTileMapNode + SKTileSet; tiles não são nós, então construa colisão separadamente |
| Texturas | Sprite Atlas no catálogo de assets, SKTextureAtlas(named:); pré-carregue antes do gameplay |
| Pixel art | texture.filteringMode = .nearest em cada textura, incluindo cada quadro do atlas |
| Partículas | Arquivos .sks de emissores, SKEmitterNode(fileNamed:); defina targetNode = scene para rastros |
| Shaders, luzes, filtros, deformações | Leia references/effects.md |
| Som de uma vez | SKAction.playSoundFileNamed; algo mais usa a habilidade game-audio-engine |
| Integração Metal | SKRenderer desenha uma cena dentro de seu próprio passe Metal |
Desempenho
- Agrupamento: nós que compartilham uma textura ou atlas desenham em uma chamada. Atlas misturados e nós sobrepostos em diferentes
zPositions quebram os agrupamentos. ObserveshowsDrawCount. - Remova nós fora da tela com
removeFromParent(); a poda ainda visita cada nó a cada quadro. - Caros, use com moderação:
SKEffectNodecomCIFilter,SKCropNode, muitosSKShapeNodes, umSKShaderpor sprite e alterações de fonte de shader em tempo de execução (cada uma recompila). SKShapeNodeé para desenho de depuração. "Asse" uma forma uma vez comview.texture(from:)e desenhe sprites.- Crie perfil em um dispositivo com o template Game Performance do Instruments e o HUD de Performance Metal (Scheme > Run > Diagnostics > Show Graphics Overview).
Armadilhas
contactTestBitMaskpadrão é 0, enquantocategoryBitMaskecollisionBitMaskpadrão são todos os bits. Defina todos os três para cada corpo.UIScreen.mainestá obsoleto no iOS 26. Leia a taxa de atualização deview.window?.windowScene?.screen.maximumFramesPerSecond.- A fonte de
SKShaderé GLSL ES, não a Metal Shading Language. physicsWorld.contactDelegatenão é retido.- Com
.ignoresSiblingOrder, nós comzPositionigual desenham em ordem arbitrária.
Habilidades relacionadas
Entrada e hápticos: game-controller. Som: game-audio-engine. Visual, paleta e "juice": game-art-direction. Layout de grade e salas: game-level-design.