SpriteKit は何をしますか?
SpriteKitは、iOS向け2Dゲームのデフォルトレンダラーです。サポートは継続されており、非推奨ではありません。ただし、そのAPIはiOS 12以降凍結されているため、すべてのSpriteKit呼び出しはiOS 26上で#availableチェックなしで動作します。プロジェクト全体の設定(ゲームモード、ProMotion、アプリカテゴリ)は、ios-game-designスキルにあります。
SK3DNodeは避けてください。これはSceneKitを埋め込みますが、SceneKitはiOS 26以降非推奨です。3Dが必要な場合はrealitykitスキルを使用してください。
SwiftUIでシーンをホストする
import SwiftUI
import SpriteKit
struct GameView: View {
@State private var scene: GameScene = { // 一度だけ作成。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]) // デバッグビルドのみ
.ignoresSafeArea()
.statusBarHidden()
.persistentSystemOverlays(.hidden)
}
}
SpriteViewのデフォルトはゲームには適していないため、上書きしてください:
preferredFramesPerSecondはデフォルトで60です。120を指定し、Info.plistにCADisableMinimumFrameDurationOnPhoneを追加してください。そうしないとiPhoneは60Hzのままです。optionsのデフォルトは[.shouldCullNonVisibleNodes]のため、.ignoresSiblingOrderはオフです。これをオンにし、描画順序が重要な場所でzPositionを設定してください。
スケールモード:.aspectFitはレターボックス表示、.aspectFillはクロップ、.resizeFillはビューサイズに追従します(didChangeSize(_:)で再レイアウト)。アスペクトモードで固定デザインサイズを選ぶか、.resizeFillでアダプティブレイアウトを使用してください。ワールドはフルブリードに保ち、HUDとタッチターゲットだけをview.safeAreaInsetsでインセットするか、HUDをSwiftUIのオーバーレイとして描画してください。
Swift 6 並行性
SKNode(したがってSKScene)は@MainActorであり、UIResponderから継承されています。シーン内で作成されたクロージャ(SKAction.run、customAction)はメインアクターを継承します。SKPhysicsContactDelegateは非分離(nonisolated)であるため、デフォルトのメインアクター分離がない状態でclass GameScene: SKScene, SKPhysicsContactDelegateと書くと、Swift 6でコンパイルが失敗します。分離された適合を記述すると、すべての設定でコンパイルできます:SKScene, @MainActor SKPhysicsContactDelegate。- 非同期形式(
await atlas.preload()、await SKTexture.preload(textures))でプリロードしてください。完了ハンドラ形式は@Sendableであり、ノードに触れると警告が出ます。 await node.run(action)はアクションの終了時に再開されます。短いシーケンスに適しています。repeatForeverでは決して再開されません。- 新しいXcodeプロジェクトのデフォルトはSwift 5言語モードです。
SWIFT_VERSION = 6を明示的に設定してください。
フレームループ
1フレームあたりの順序:update(_:) → アクション → didEvaluateActions() → 物理(コンタクトコールバックはここで発生) → didSimulatePhysics() → 制約 → didApplyConstraints() → didFinishUpdate() → レンダリング。
currentTimeは絶対時間です。dtを自分で計算し、クランプしてください(例:1/30秒)。これにより、ポーズやヒッチがオブジェクトを瞬間移動させることを防ぎます。- フレームレートは低電力モードやサーマル状態によって変動します。すべての動きを
dtでスケーリングしてください。 didBegin/didEnd内で物理ボディを追加、削除、変形しないでください。変更をキューに入れ、didSimulatePhysics()または次のupdateで適用してください。- 1フレーム内のアクションの順序は未指定です。最終位置は
didEvaluateActions()以降で読み取ってください。
シーンスケルトン
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 // 非保持(unowned):シーンは生存している必要があります
addChild(cam); camera = cam // camの子ノードは画面固定のHUDを形成します
let body = SKPhysicsBody(circleOfRadius: 12)
body.categoryBitMask = Category.player
body.collisionBitMask = Category.wall
body.contactTestBitMask = Category.enemy // デフォルト0: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() { // 物理を変更しても安全なポイント
pendingRemovals.forEach { $0.removeFromParent() }
pendingRemovals.removeAll()
}
func didBegin(_ contact: SKPhysicsContact) { // 記録のみ。ここで絶対に変更しないでください
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) { /* dtでスケーリングされたゲームロジック */ }
}
ビルディングブロック
| 必要なもの | 使用するもの |
|---|---|
| カメラ、HUD | SKCameraNode。HUDノードはカメラの子として配置 |
| トゥイーン、イージング | SKActionとtimingModeまたはカスタムtimingFunction |
| スプライトアニメーション | SKAction.animate(with:timePerFrame:)とアトラステクスチャ |
| 物理 | SKPhysicsBody(円/矩形が最も軽量)、マスクは明示的に設定、小さく速いボディにはusesPreciseCollisionDetection |
| グリッドレベル | SKTileMapNode + SKTileSet。タイルはノードではないため、衝突判定は別途構築 |
| テクスチャ | アセットカタログのスプライトアトラス、SKTextureAtlas(named:)。ゲームプレイ前にプリロード |
| ドット絵 | すべてのテクスチャ(各アトラスフレームを含む)でtexture.filteringMode = .nearest |
| パーティクル | .sksエミッターファイル、SKEmitterNode(fileNamed:)。トレイルにはtargetNode = sceneを設定 |
| シェーダ、ライト、フィルタ、ワープ | references/effects.md を参照 |
| 単発効果音 | SKAction.playSoundFileNamed。それ以上のことはgame-audio-engineスキルを使用 |
| Metal統合 | SKRendererで独自のMetalパス内にシーンを描画 |
パフォーマンス
- バッチ処理:同じテクスチャまたはアトラスを共有するノードは1回のドローコールで描画されます。アトラスが混在したり、異なる
zPositionのノードが重なるとバッチが分割されます。showsDrawCountを監視してください。 - 画面外のノードは
removeFromParent()で削除してください。カリングはそれでも毎フレームすべてのノードを訪問します。 - 重く、控えめに使用すべきもの:
CIFilterを使用するSKEffectNode、SKCropNode、多数のSKShapeNode、スプライトごとのSKShader、およびランタイムでのシェーダソース変更(再コンパイルが発生)。 SKShapeNodeはデバッグ描画用です。シェイプを一度view.texture(from:)でベイクし、スプライトを描画してください。- InstrumentsのGame PerformanceテンプレートとMetal Performance HUD(Scheme > Run > Diagnostics > Show Graphics Overview)を使用して、デバイス上でプロファイリングしてください。
注意点
contactTestBitMaskのデフォルトは0ですが、categoryBitMaskとcollisionBitMaskのデフォルトは全ビットです。すべてのボディに3つすべてを設定してください。UIScreen.mainはiOS 26で非推奨です。リフレッシュレートはview.window?.windowScene?.screen.maximumFramesPerSecondから読み取ってください。SKShaderのソースはGLSL ESであり、Metal Shading Languageではありません。physicsWorld.contactDelegateは保持されません。.ignoresSiblingOrderが有効な場合、同じzPositionのノードは任意の順序で描画されます。
関連スキル
入力と触覚:game-controller。サウンド:game-audio-engine。ルック、パレット、演出:game-art-direction。グリッドと部屋のレイアウト:game-level-design。