PyObjC SoundAnalysis Framework

Warnings

• breaking PyObjC version 12.0 dropped support for Python 3.9. Ensure your Python version meets the `pyobjc` requirements (Python 3.10+ for 12.x).
  Fix: Upgrade to Python 3.10 or later, or use an older PyObjC version (e.g., PyObjC 11.x for Python 3.9 support).
• breaking Starting with PyObjC 12.0, the `AVFAudio` framework (containing core audio classes like `AVAudioFormat`) was split into its own top-level package and is no longer merged into `AVFoundation`. Imports must be updated.
  Fix: Change imports from `from AVFoundation import ...` to `from AVFAudio import ...` for `AVAudio*` related classes.
• breaking PyObjC 11.1 aligned its behavior for Objective-C `init` family methods with `clang`'s Automatic Reference Counting (ARC) rules. Methods in the 'init' family now correctly steal a reference to `self` and return a new reference, which can affect memory management if not previously accounted for.
  Fix: Review custom Python subclasses of Objective-C objects, especially their `__init__` or `init*` methods, to ensure correct reference counting and object lifecycle management.
• gotcha PyObjC 10.3 introduced a change that prevented `__init__` from being called when a user implemented `__new__`, leading to unexpected behavior. This was quickly fixed in 10.3.1, but highlights potential interactions with `__new__`.
  Fix: Ensure you are using PyObjC 10.3.1 or later if you have Python classes that implement both `__new__` and `__init__` and derive from `objc.lookUpClass('NSObject')` or similar PyObjC bridged classes.

Install

• pip install pyobjc-framework-soundanalysis Install specific framework
• pip install pyobjc Install all PyObjC frameworks (recommended)

Imports

• SAAudioAnalyzer

  from SoundAnalysis import SAAudioAnalyzer

• SADetectSpeechRequest

  from SoundAnalysis import SADetectSpeechRequest

Quickstart

Demonstrates how to import and instantiate a basic class from the SoundAnalysis framework. This example creates a `SADetectSpeechRequest`, a common analysis request type.

from SoundAnalysis import SADetectSpeechRequest
from Foundation import NSError # Common for PyObjC error handling
import objc # Core PyObjC utilities

# Create an instance of a SoundAnalysis request
# SADetectSpeechRequest can be initialized without complex audio formats.
error = objc.nil # Placeholder for NSError object
speech_request = SADetectSpeechRequest.alloc().init()

if speech_request:
    print(f"Successfully created SADetectSpeechRequest: {speech_request}")
    # In a real application, you would typically add this request to an SAAudioAnalyzer:
    # from SoundAnalysis import SAAudioAnalyzer
    # # ... (setup AVAudioFormat and SAAudioAnalyzer)
    # analyzer.addAnalysisRequest_error_(speech_request, error)
else:
    print(f"Failed to create SADetectSpeechRequest. Error: {error}")