クラス

MAFlashingLightsProcessor

フレームバッファオブジェクトを処理して、一連の点滅ライトを検出して暗くするクラス。

iOS 17.0+ iPadOS 17.0+ macOS 14.0+ Mac Catalyst 17.0+ tvOS 17.0+ visionOS 1.0+ Beta

class MAFlashingLightsProcessor : NSObject

概観

[薄暗く点滅するライト] 設定がオンになっているデバイスは、ビデオコンテンツ内で点滅エフェクトシーケンスを検出すると、その明るさを自動的に薄暗くします。あなたのアプリが AVFoundation API を使用する代わりにカスタムビデオ描画を実行する場合は、MAFlashingLightsProcessor クラスを使用して、あなたのビデオコンテンツ内の一連の点滅効果を検出して軽減できます。

以下の例は、コアビデオ (Core Video) API を使用するコードに MAFlashingLightsProcessor を組み込む方法を示しています。

import MediaAccessibility
import CoreVideo
import OSLog
private let processor = MAFlashingLightsProcessor()
private let logger = Logger()
func readVideoBuffer() {
// Confirm that the Dim Flashing Lights setting is on before processing video.
if !MADimFlashingLightsEnabled() { return }
// Retrieve the CVPixelBuffer from your video content.
// ...
// Get the IOSurface that backs the pixel buffer.
guard let inSurface = CVPixelBufferGetIOSurface(pixelBuffer)?.takeUnretainedValue() else {
logger.debug("Can't initialize input surface.")
return
}
// Use the properties of the pixel buffer to initialize an output IOSurface.
guard var outSurface = IOSurface(properties: [
.width: CVPixelBufferGetWidth(pixelBuffer),
.height: CVPixelBufferGetHeight(pixelBuffer),
.bytesPerRow: CVPixelBufferGetWidth(pixelBuffer) * 4,
.bytesPerElement: 4,
.pixelFormat: CVPixelBufferGetPixelFormatType(pixelBuffer)
]) as IOSurfaceRef? else {
logger.debug("Can't initialize output surface.")
return
}
// Verify that the input IOSurface is compatible with the flashing lights processor.
if processor.canProcessSurface(inSurface) {
// Analyze input IOSurface for flashing light sequences
// and write mitigated content to output IOSurface.
let result = processor.processSurface(inSurface, outSurface: &outSurface,
timestamp: CFAbsoluteTimeGetCurrent())
if result.surfaceProcessed {
logger.debug("""
Processed content with flashing lights intensity \(result.intensityLevel)
and mitigated output with mitigation level \(result.mitigationLevel).
""")
// Convert the mitigated output surface back to CVPixelBuffer
// and draw the video content.
// ...
} else {
logger.debug("Can't process input surface.")
}
}
}