PyObjC AudioVideoBridging Framework

Warnings

• breaking PyObjC 12.0 dropped support for Python 3.9, and PyObjC 11.0 dropped support for Python 3.8. Users on these Python versions must use older PyObjC releases.
  Fix: Upgrade Python to 3.10 or later, or pin PyObjC to a compatible older version.
• breaking PyObjC 11.1 introduced a significant change in how initializer methods (methods in the 'init' family) are modeled, aligning with `clang`'s Automatic Reference Counting documentation. These methods now correctly 'steal' a reference to `self` and return a new one. This can lead to unexpected reference counting behavior if existing code relied on the previous modeling.
  Fix: Review code involving Objective-C initializer methods and `alloc().init()` patterns, ensuring correct object lifecycle management. PyObjC 10.3 introduced `SomeClass(...)` as a more Pythonic alternative to `SomeClass.alloc().init()`.
• breaking PyObjC 10.3 temporarily broke support for `__init__` methods in Python subclasses when a user also provided a custom `__new__` method. While fixed in 10.3.1, this was a breaking change for affected patterns.
  Fix: Upgrade to PyObjC 10.3.1 or later to restore `__init__` functionality when `__new__` is user-implemented. Avoid relying on `__init__` for classes using the PyObjC-provided `__new__`.
• deprecated The `IMServicePlugIn` framework bindings were removed in PyObjC 10.0, as the framework itself was deprecated in macOS 10.13 and removed in macOS 14.
  Fix: Migrate away from the `IMServicePlugIn` framework; find alternative APIs provided by Apple for modern macOS versions.
• gotcha Using weak references from Objective-C to plain Python objects can cause hard crashes rather than Python exceptions, as the Objective-C proxy object might be deallocated while the Python object is still alive.
  Fix: Ensure that if Objective-C code holds weak references to Python objects, the Python objects (or their Objective-C proxies) are explicitly kept alive for the necessary duration. For objects used in views like `NSOutlineView`, it's generally safer to use Python subclasses of `NSObject`.
• gotcha As of PyObjC 12.1, Key-Value Observing (KVO) usage is automatically disabled for subclasses of `NSProxy` defined in Python to prevent `SystemError` issues.
  Fix: Be aware that KVO will not function for Python subclasses of `NSProxy`. If KVO behavior is required, consider alternative implementation patterns or subclassing a different Objective-C class if applicable.

Install

• pip install pyobjc-framework-audiovideobridging Install latest version

Imports

• AudioVideoBridging

  import AudioVideoBridging

  This imports the entire AudioVideoBridging framework as a module. Individual classes like AVBManager are then accessed as attributes of this module (e.g., AudioVideoBridging.AVBManager).

Quickstart

This quickstart demonstrates how to import the AudioVideoBridging framework and access a fundamental class, `AVBManager`. PyObjC framework wrappers provide direct access to Objective-C classes and methods. Note that PyObjC itself does not include documentation for the wrapped macOS APIs; developers should consult Apple's official AudioVideoBridging documentation for detailed usage of the framework's classes and functions.

import AudioVideoBridging
import Foundation # Often needed for basic Cocoa types

try:
    # Access the shared manager instance for the AudioVideoBridging framework
    # This is a common pattern in Cocoa frameworks.
    manager = AudioVideoBridging.AVBManager.sharedManager()
    print(f"Successfully accessed AVBManager: {manager}")

    # For actual functionality, refer to Apple's AudioVideoBridging documentation.
    # Example (conceptual, requires deeper understanding of AVB framework):
    # interfaces = manager.availableInterfaces()
    # if interfaces:
    #     print("Available AVB Interfaces:")
    #     for interface in interfaces:
    #         print(f"  - Name: {interface.name()}, Entity ID: {interface.entityID()}")
    # else:
    #     print("No AVB interfaces found.")

except Exception as e:
    print(f"Error accessing AudioVideoBridging framework: {e}")