iPhone/iOSアプリからプログラムでスクリーンショットを撮影・保存する方法

プログラムによるスクリーンショット撮影の基本

iOSには、デバイスの画面をプログラムから直接キャプチャするための公式APIは用意されていません。ユーザーが手動でスクリーンショットを撮るには、サイドボタン（電源ボタン）と音量上げボタンを同時に押す方法が標準ですが、アプリ内で自動的に画面をキャプチャしたい場合は、UIViewのレンダリング機能を利用することになります。

処理の流れは以下の通りです。

• keyWindowのレイヤーを取得する（UIApplication.shared.keyWindow!.layer）
• 画面のスケールを取得する（UIScreen.main.scale）
• ビューと同じサイズの画像コンテキストを新しく作成する
• レイヤーをコンテキストに描画し、画像として保存する

実装手順

まず新規プロジェクトを作成し、メインのビューコントローラーに背景色を設定します。次にボタンを1つ配置し、アクションとしてクラスに接続しましょう。アクション内に以下のコードを追加します。

@IBAction func takeshot(_ sender: Any) {
    var image :UIImage?
    let currentLayer = UIApplication.shared.keyWindow!.layer
    let currentScale = UIScreen.main.scale
    UIGraphicsBeginImageContextWithOptions(currentLayer.frame.size, false, currentScale)
    guard let currentContext = UIGraphicsGetCurrentContext() else { return }
    currentLayer.render(in: currentContext)
    image = UIGraphicsGetImageFromCurrentImageContext()
    UIGraphicsEndImageContext()
    guard let img = image else { return }
    UIImageWriteToSavedPhotosAlbum(img, nil, nil, nil)
}

必要な設定と注意点

このコードを初めて実行する際には、「写真」ライブラリへの書き込み権限を求めるダイアログが表示されるので、許可してください。保存される画像は.jpg形式になります。

また、アプリのInfo.plistに「NSPhotoLibraryAddUsageDescription」キーを必ず追加してください。この記述がないと、権限ダイアログが表示されずにアプリがクラッシュする原因となります。

この処理は関数として切り出せば複数箇所で使い回せるほか、UIViewの拡張（extension）として定義しておくのも便利です。

動作確認

アプリを実行すると、次のような画面が表示されます。

初回起動後に「take shot」ボタンをタップすると、写真へのアクセス許可を求めるアラートが表示されます。

アクセスを許可した後、iPhoneの「写真」アプリを開くと、保存されたスクリーンショットを確認できます。

補足：iOS 13以降の推奨実装

UIApplication.shared.keyWindowはiOS 13以降で非推奨（deprecated）となっています。現在のシーンからウィンドウを取得し、UIGraphicsImageRendererを使うことで、よりモダンかつ安全に同じことが実現できます。

if let window = view.window {
    let renderer = UIGraphicsImageRenderer(size: window.bounds.size)
    let screenshot = renderer.image { _ in
        window.drawHierarchy(in: window.bounds, afterScreenUpdates: true)
    }
    UIImageWriteToSavedPhotosAlbum(screenshot, nil, nil, nil)
}

新しいプロジェクトで実装する場合は、こちらの方法を採用することをおすすめします。