PyObjC CoreMediaIO Framework

Warnings

• breaking PyObjC frequently drops support for older Python versions. PyObjC 12.0 dropped support for Python 3.9; PyObjC 11.0 dropped support for Python 3.8. Always check `requires_python` metadata or release notes for compatibility.
  Fix: Ensure your Python environment meets the `requires_python` specification (e.g., >=3.10 for PyObjC 12.1) before upgrading PyObjC.
• breaking In PyObjC 10.3, the ability to call `__init__` when a Python user class implemented `__new__` was initially removed, then partially reintroduced in 10.3.1. Code relying on `__new__` provided by PyObjC still cannot use `__init__`.
  Fix: Review custom `__new__` and `__init__` implementations in Python subclasses of Objective-C classes. If overriding `__new__`, ensure Objective-C style `init` methods (e.g., `initWithFoo_:`) are used where appropriate.
• breaking PyObjC 11.1 aligned its core bridge with `clang`'s Automatic Reference Counting (ARC) documentation for Objective-C initializer methods ('init' family). These methods now correctly steal a reference to `self` and return a new reference, which may alter reference counting behavior in some existing code, particularly with `[NSObject alloc]` proxies.
  Fix: Review Python code interacting with Objective-C initializer methods, especially those dealing with `alloc`/`init` patterns, to ensure correct reference management. PyObjC 10.3 introduced a more Pythonic `Class(...)` instantiation pattern that is generally safer.
• breaking Starting with PyObjC 12.0, the `AVFAudio` framework was split into a separate top-level package (`AVFAudio`) instead of being merged into `AVFoundation`. While still included in the `pyobjc-framework-AVFoundation` distribution, direct imports must be updated.
  Fix: Update imports from `AVFoundation.AVFAudio...` to `AVFAudio...` where applicable.
• breaking The `IMServicePlugIn` framework bindings were removed in PyObjC 10.0, as the underlying framework was deprecated by Apple in macOS 10.13 and completely removed in macOS 14.
  Fix: Update or remove code that depends on the `IMServicePlugIn` framework. Consider alternative APIs if functionality is still required.

Install

• pip install pyobjc-framework-coremediaio Install CoreMediaIO bindings

Imports

• CoreMediaIO

  import CoreMediaIO

  Imports the entire CoreMediaIO framework namespace.
• kCMIOObjectSystemObject

  from CoreMediaIO import kCMIOObjectSystemObject

  Imports a specific constant from the CoreMediaIO framework. Most interactions are with C functions and constants.

Quickstart

Demonstrates how to import the CoreMediaIO framework and access a fundamental constant. Due to CoreMediaIO being a C-based API framework, complex interactions often require understanding PyObjC's handling of C functions, pointers, and structs.

import CoreMediaIO
import os

# CoreMediaIO is a low-level C API framework, primarily dealing with constants, 
# functions, and structs. This quickstart demonstrates importing the framework 
# and accessing a fundamental system object constant to confirm setup.

# Check if the kCMIOObjectSystemObject constant is available
if hasattr(CoreMediaIO, 'kCMIOObjectSystemObject'):
    system_object_id = CoreMediaIO.kCMIOObjectSystemObject
    print(f"CoreMediaIO.kCMIOObjectSystemObject found: {system_object_id}")
else:
    print("CoreMediaIO.kCMIOObjectSystemObject not found, framework might not be fully loaded or API changed.")

# Note: More complex interactions with CoreMediaIO (e.g., enumerating devices,
# getting property data) typically involve Objective-C C-style function calls
# requiring knowledge of `objc` bridge types (like pointers and structs).
# Refer to Apple's CoreMediaIO documentation and PyObjC examples for advanced usage.