Communityコーディング&開発github.com

SpriteKit

iOS 2Dゲーム開発スキル。SpriteKitとSwiftUIを組み合わせ、Swift 6対応でシーン管理、アニメーション、物理演算、パーティクル、パフォーマンス最適化を実現します。

SpriteKit とは?

このスキルは、Appleの2Dゲームレンダリングフレームワーク「SpriteKit」を専門に扱います。iOS 26+およびSwift 6向けに設計されており、SpriteViewのSwiftUIホスティング、フレームループ制御、物理エンジン、カメラシステム、タイルマップ、パーティクル、シェーダ、ライティング、ドローコール最適化など、実践的なゲーム開発パターンを提供します。 特に推奨されるのは、SpriteViewのデフォルト設定(60fps)を120fpsに変更し、Info.plistと組み合わせて高リフレッシュレートを有効化する方法や、非推奨API(SK3DNode)を避け、Swift 6の並行性モデルに準拠したコード例を示す点です。また、物理コンタクトデリゲートのMainActor分離問題への対処法、フレームループ内で状態変更をキューイングするベストプラクティス、パフォーマンスプロファイリングの手法も網羅しています。 このスキルは、2Dゲームのレンダリングが遅い、表示がおかしい、SpriteKitコードのデバッグが必要な開発者にとって非常に有用です。具体的なコードスニペットとともに、フレームループの各フェーズの実行順序、様々なビルディングブロック(カメラ、アクション、物理ボディ、タイルマップなど)の使い分け、およびパフォーマンスチューニングのためのヒントを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/andersmoldin/ios-game-creator-skills/tree/HEAD/skills/spritekit

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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でスケーリングされたゲームロジック */ }
}

ビルディングブロック

必要なもの使用するもの
カメラ、HUDSKCameraNode。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。

関連スキル