Que fait spritekit ?
SpriteKit est le moteur de rendu par défaut pour les jeux 2D iOS. Il est pris en charge et non déprécié, mais son API est figée depuis iOS 12, donc tout appel SpriteKit fonctionne sur iOS 26 sans vérification #available. Les paramètres à l'échelle du projet (mode de jeu, ProMotion, catégorie d'application) se trouvent dans la compétence ios-game-design.
Évitez SK3DNode : il intègre SceneKit, qui est déprécié depuis iOS 26. Utilisez la compétence realitykit pour la 3D.
Héberger la scène dans SwiftUI
import SwiftUI
import SpriteKit
struct GameView: View {
@State private var scene: GameScene = { // créer une fois ; jamais à l'intérieur de 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]) // builds de débogage uniquement
.ignoresSafeArea()
.statusBarHidden()
.persistentSystemOverlays(.hidden)
}
}
Les valeurs par défaut de SpriteView ne sont pas adaptées aux jeux ; remplacez-les :
preferredFramesPerSecondpar défaut à 60. Passez 120 et ajoutezCADisableMinimumFrameDurationOnPhoneà Info.plist, sinon l'iPhone reste à 60 Hz.optionspar défaut à[.shouldCullNonVisibleNodes], donc.ignoresSiblingOrderest désactivé. Activez-le et définissezzPositionlà où l'ordre d'affichage est important.
Modes d'échelle : .aspectFit ajoute des bandes noires, .aspectFill rogne, .resizeFill suit la taille de la vue (réorganisation dans didChangeSize(_:)). Choisissez une taille de conception fixe avec un mode d'aspect, ou .resizeFill avec une disposition adaptative. Gardez le monde en plein écran et insérez uniquement le HUD et les zones tactiles par view.safeAreaInsets, ou dessinez le HUD comme une superposition SwiftUI.
Concurrence Swift 6
SKNode(et doncSKScene) est@MainActor, hérité deUIResponder. Les closures créées dans une scène (SKAction.run,customAction) héritent de l'acteur principal.SKPhysicsContactDelegateest non isolé, donc sans isolation par défaut de l'acteur principalclass GameScene: SKScene, SKPhysicsContactDelegatene compile pas en Swift 6. Écrivez une conformité isolée, qui compile sous tous les réglages :SKScene, @MainActor SKPhysicsContactDelegate.- Préchargez avec les formes asynchrones (
await atlas.preload(),await SKTexture.preload(textures)) ; les formes avec gestionnaire d'achèvement sont@Sendableet émettent un avertissement lorsqu'elles touchent des nodes. await node.run(action)reprend lorsque l'action se termine, ce qui convient aux séquences courtes. Il ne reprend jamais pourrepeatForever.- Les nouveaux projets Xcode par défaut en mode langage Swift 5 ; définissez
SWIFT_VERSION = 6explicitement.
Boucle d'images
Ordre par image : update(_:) → actions → didEvaluateActions() → physique (les callbacks de contact se déclenchent ici) → didSimulatePhysics() → contraintes → didApplyConstraints() → didFinishUpdate() → rendu.
currentTimeest absolu. Calculezdtvous-même et limitez-le (par exemple à 1/30 s) pour qu'une pause ou un accroc ne téléporte jamais les objets.- Le taux d'images varie avec le mode basse consommation et l'état thermique. Mettez à l'échelle tout mouvement par
dt. - N'ajoutez, ne supprimez ou ne redimensionnez jamais de corps physiques à l'intérieur de
didBegin/didEnd. Mettez en file d'attente le changement et appliquez-le dansdidSimulatePhysics()ou la prochaineupdate. - L'ordre des actions dans une image n'est pas spécifié. Lisez les positions finales dans
didEvaluateActions()ou plus tard.
Squelette de scène
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 // détenu non retenu : la scène doit rester en vie
addChild(cam); camera = cam // les enfants de cam forment un HUD fixe à l'écran
let body = SKPhysicsBody(circleOfRadius: 12)
body.categoryBitMask = Category.player
body.collisionBitMask = Category.wall
body.contactTestBitMask = Category.enemy // par défaut 0 : aucun appel didBegin du tout
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() { // point sûr pour muter la physique
pendingRemovals.forEach { $0.removeFromParent() }
pendingRemovals.removeAll()
}
func didBegin(_ contact: SKPhysicsContact) { // enregistrer seulement ; ne jamais muter ici
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) { /* logique de jeu mise à l'échelle par dt */ }
}
Éléments de base
| Besoin | Utilisation |
|---|---|
| Caméra, HUD | SKCameraNode ; nodes HUD comme enfants de la caméra |
| Interpolations, easings | SKAction avec timingMode ou une timingFunction personnalisée |
| Animation de sprite | SKAction.animate(with:timePerFrame:) sur les textures d'atlas |
| Physique | SKPhysicsBody (cercle/rect le moins cher), masques définis explicitement, usesPreciseCollisionDetection pour les petits corps rapides |
| Niveaux en grille | SKTileMapNode + SKTileSet ; les tuiles ne sont pas des nodes, donc construisez la collision séparément |
| Textures | Atlas de sprites dans le catalogue d'actifs, SKTextureAtlas(named:) ; préchargez avant le jeu |
| Pixel art | texture.filteringMode = .nearest sur chaque texture, y compris chaque image d'atlas |
| Particules | Fichiers émetteurs .sks, SKEmitterNode(fileNamed:) ; définissez targetNode = scene pour les traînées |
| Shaders, lumières, filtres, déformations | Consultez references/effects.md |
| Son ponctuel | SKAction.playSoundFileNamed ; tout ce qui dépasse utilise la compétence game-audio-engine |
| Intégration Metal | SKRenderer dessine une scène à l'intérieur de votre propre passe Metal |
Performances
- Regroupement : les nodes qui partagent une texture ou un atlas s'affichent en un seul appel. Les atlas mélangés et les nodes qui se chevauchent à différents
zPositiondivisent les lots. SurveillezshowsDrawCount. - Supprimez les nodes hors écran avec
removeFromParent(); l'élagage visite toujours chaque node à chaque image. - Coûteux, à utiliser avec parcimonie :
SKEffectNodeavecCIFilter,SKCropNode, nombreuxSKShapeNodes, unSKShaderpar sprite, et les modifications de source de shader à l'exécution (chacune recompile). SKShapeNodeest pour le dessin de débogage. Cuisez une forme une fois avecview.texture(from:)et dessinez des sprites.- Profilez sur un appareil avec le modèle Game Performance d'Instruments et le HUD de performances Metal (Scheme > Run > Diagnostics > Show Graphics Overview).
Pièges
contactTestBitMaskpar défaut à 0, tandis quecategoryBitMasketcollisionBitMaskpar défaut à tous les bits. Définissez les trois pour chaque corps.UIScreen.mainest déprécié dans iOS 26. Lisez le taux de rafraîchissement à partir deview.window?.windowScene?.screen.maximumFramesPerSecond.- La source
SKShaderest en GLSL ES, pas en Metal Shading Language. physicsWorld.contactDelegaten'est pas retenu.- Avec
.ignoresSiblingOrder, les nodes àzPositionégal s'affichent dans un ordre arbitraire.
Compétences connexes
Entrées et retour haptique : game-controller. Son : game-audio-engine. Aspect visuel, palette et effets : game-art-direction. Disposition de la grille et des pièces : game-level-design.