onvif-python 0.0.7__tar.gz → 0.0.9__tar.gz

{onvif_python-0.0.7/onvif_python.egg-info → onvif_python-0.0.9}/PKG-INFO

@@ -1,14 +1,11 @@
 Metadata-Version: 2.4
 Name: onvif-python
-Version: 0.0.7
+Version: 0.0.9
 Summary: A comprehensive and developer-friendly Python library for working with ONVIF-compliant devices
 Author-email: Nirsimetri Technologies® <open@nirsimetri.com>
 Maintainer: Kaburagi
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/nirsimetri/onvif-python
-Project-URL: Issues, https://github.com/nirsimetri/onvif-python/issues
 Project-URL: Documentation, https://deepwiki.com/nirsimetri/onvif-python
-Project-URL: Repository, https://github.com/nirsimetri/onvif-python.git
 Project-URL: Changelog, https://github.com/nirsimetri/onvif-python/releases
 Keywords: onvif,Camera,onvif-python,ip-camera,cctv,soap,surveillance,cctv cameras,soap-client,onvif-client,onvif-library,onvif-specifications
 Classifier: Development Status :: 5 - Production/Stable
@@ -31,8 +28,8 @@ Classifier: Natural Language :: Indonesian
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
-Requires-Dist: zeep>=4.2.1
-Requires-Dist: requests>=2.28.0
+Requires-Dist: zeep>=4.3.0
+Requires-Dist: requests>=2.32.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: black; extra == "dev"
@@ -43,14 +40,11 @@ Dynamic: license-file
 
 [![License](https://img.shields.io/badge/License-MIT-blue)](https://github.com/nirsimetri/onvif-python?tab=MIT-1-ov-file)
 [![DeepWiki](https://img.shields.io/badge/DeepWiki-AI%20Wiki-orange)](https://deepwiki.com/nirsimetri/onvif-python)
-[![Release](https://img.shields.io/badge/Release-v0.0.7-red?logo=archive)](https://github.com/nirsimetri/onvif-python/releases)
+[![Release](https://img.shields.io/badge/Release-v0.0.9-red?logo=archive)](https://github.com/nirsimetri/onvif-python/releases)
 <br>
-[![PyPI](https://img.shields.io/badge/PyPI-0.0.7-yellow?logo=archive)](https://pypi.org/project/onvif-python/)
+[![PyPI](https://img.shields.io/badge/PyPI-0.0.9-yellow?logo=archive)](https://pypi.org/project/onvif-python/)
 [![Downloads](https://img.shields.io/pypi/dm/onvif-python?label=PyPI%20Downloads)](https://clickpy.clickhouse.com/dashboard/onvif-python)
 
-Are you having trouble finding a Python ONVIF library that supports your device?  
-Are you confused about the compatibility of the various ONVIF versions, which are updated every six months?
-
 **This project provides a comprehensive and developer-friendly Python library for working with ONVIF-compliant devices.** It is designed to be reliable, easy to integrate, and flexible enough to support a wide range of ONVIF profiles and services.  
 
 **[ONVIF](https://www.onvif.org) (Open Network Video Interface Forum)** is a global standard for the interface of IP-based physical security products, including network cameras, video recorders, and related systems.  
@@ -154,7 +148,9 @@ Explore more advanced usage and service-specific operations in the [`examples/`]
 
 The `ONVIFClient` class provides various configuration options to customize the connection behavior, caching strategy, security settings, and debugging capabilities. Below is a detailed description of all available parameters:
 
-### Basic Parameters
+
+<details>
+<summary><b>Basic Parameters</b></summary>
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
@@ -163,7 +159,10 @@ The `ONVIFClient` class provides various configuration options to customize the
 | `username` | `str` | ✅ Yes | - | Username for device authentication (use digest authentication) |
 | `password` | `str` | ✅ Yes | - | Password for device authentication |
 
-### Connection Parameters
+</details>
+
+<details>
+<summary><b>Connection Parameters</b></summary>
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
@@ -171,33 +170,45 @@ The `ONVIFClient` class provides various configuration options to customize the
 | `use_https` | `bool` | ❌ No | `False` | Use HTTPS instead of HTTP for secure communication |
 | `verify_ssl` | `bool` | ❌ No | `True` | Verify SSL certificates when using HTTPS (set to `False` for self-signed certificates) |
 
-### Caching Parameters
+</details>
+
+<details>
+<summary><b>Caching Parameters</b></summary>
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
 | `cache` | `CacheMode` | ❌ No | `CacheMode.ALL` | WSDL caching strategy (see [Cache Modes](#cache-modes) below) |
 
-### Feature Parameters
+</details>
+
+<details>
+<summary><b>Feature Parameters</b></summary>
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `apply_patch` | `bool` | ❌ No | `True` | Enable zeep patching for better xsd:any field parsing and automatic flattening |
+| `apply_patch` | `bool` | ❌ No | `True` | Enable zeep patching for better `xsd:any` field parsing and automatic flattening |
 | `capture_xml` | `bool` | ❌ No | `False` | Enable XML capture plugin for debugging SOAP requests/responses |
 
-### Cache Modes
+</details>
+
+<details>
+<summary><b>Cache Modes</b></summary> 
 
 The library provides four caching strategies via the `CacheMode` enum:
 
 | Mode | Description | Best For | Startup Speed | Disk Usage | Memory Usage |
 |------|-------------|----------|---------------|------------|--------------|
-| `CacheMode.ALL` | In-memory + disk cache (SQLite) | Production servers, multi-device apps | ⚡⚡⚡ Fast | 💾 High | 🧠 High |
-| `CacheMode.DB` | Disk cache only (SQLite) | Batch jobs, CLI tools | ⚡⚡ Medium | 💾 Medium | 🧠 Low |
-| `CacheMode.MEM` | In-memory cache only | Short-lived scripts, demos | ⚡⚡ Medium | 💾 None | 🧠 Medium |
-| `CacheMode.NONE` | No caching | Testing, debugging | ⚡ Slow | 💾 None | 🧠 Low |
+| `CacheMode.ALL` | In-memory + disk cache (SQLite) | Production servers, multi-device apps | Fast | High | High |
+| `CacheMode.DB` | Disk cache only (SQLite) | Batch jobs, CLI tools | Medium | Medium | Low |
+| `CacheMode.MEM` | In-memory cache only | Short-lived scripts, demos | Medium | None | Medium |
+| `CacheMode.NONE` | No caching | Testing, debugging | Slow | None | Low |
 
 **Recommendation:** Use `CacheMode.ALL` (default) for production applications to maximize performance.
 
-### Usage Examples
+</details>
+
+<details>
+<summary><b>Usage Examples</b></summary>
 
 **Basic Connection:**
 ```python
@@ -218,8 +229,7 @@ client = ONVIFClient(
     "admin", 
     "password",
     timeout=30,
-    use_https=True,
-    verify_ssl=False  # For self-signed certificates
+    use_https=True
 )
 ```
 
@@ -237,7 +247,7 @@ client = ONVIFClient(
 )
 ```
 
-**No Caching (Testing):**
+**No Caching and No Zeep Patching (Testing):**
 ```python
 from onvif import ONVIFClient, CacheMode
 
@@ -296,7 +306,6 @@ if client.xml_plugin:
     client.xml_plugin.clear_history()
 ```
 
-> [!NOTE]
 > **XML Capture Plugin Methods:**
 > - `last_sent_xml` - Get the last SOAP request XML
 > - `last_received_xml` - Get the last SOAP response XML
@@ -308,8 +317,11 @@ if client.xml_plugin:
 > - `save_to_file(request_file, response_file)` - Save XML to files
 > - `clear_history()` - Clear captured history
 
+</details>
+
+<details>
+<summary><b>Production Configuration</b></summary>
 
-**Production Configuration:**
 ```python
 from onvif import ONVIFClient, CacheMode
 
@@ -320,13 +332,14 @@ client = ONVIFClient(
     username="admin",
     password="secure_password",
     timeout=15,
-    cache=CacheMode.ALL,        # Maximum performance
+    cache=CacheMode.ALL,        # Maximum performance (default)
     use_https=True,             # Secure communication
     verify_ssl=True,            # Verify certificates (default)
     apply_patch=True,           # Enhanced parsing (default)
     capture_xml=False           # Disable debug mode (default)
 )
 ```
+</details>
 
 ### Notes
 
@@ -338,7 +351,7 @@ client = ONVIFClient(
 ## Service Discovery: Understanding Device Capabilities
 
 > [!WARNING]
-> Before performing any operations on an ONVIF device, it is highly recommended to discover which services are available and supported by the device. This library automatically uses `GetServices` during initialization to discover service endpoints, but you can also query services manually for detailed information including capabilities.
+> Before performing any operations on an ONVIF device, it is highly recommended to discover which services are available and supported by the device. This library automatically performs comprehensive service discovery during initialization using a robust fallback mechanism.
 
 **Why discover device services?**
 
@@ -349,50 +362,84 @@ client = ONVIFClient(
 
 **How service discovery works in this library:**
 
-The `ONVIFClient` automatically calls `GetServices` during initialization to build a service map. This map is used internally to resolve service endpoints:
+The `ONVIFClient` uses a **3-tier discovery approach** to maximize device compatibility:
+
+1. **GetServices (Preferred)** - Tries `GetServices` first for detailed service information
+2. **GetCapabilities (Fallback)** - Falls back to `GetCapabilities` if `GetServices` is not supported
+3. **Default URLs (Final Fallback)** - Uses standard ONVIF URLs as last resort
 
 ```python
 from onvif import ONVIFClient
 
 client = ONVIFClient("192.168.1.17", 8000, "admin", "admin123")
 
-# Access the discovered services
-print(client.services)
-# Example output: [{'Namespace': 'http://www.onvif.org/ver10/device/wsdl', 'XAddr': '...', 'Version': {...}}, ...]
-
-# Check the service map (namespace -> XAddr mapping)
-print(client._service_map)
-# Example output: {'http://www.onvif.org/ver10/media/wsdl': 'http://192.168.1.17:8000/onvif/Media', ...}
+# Check what discovery method was used
+if client.services:
+    print("Service discovery: GetServices (preferred)")
+    print("Discovered services:", len(client.services))
+    print("Service map:", client._service_map)
+elif client.capabilities:
+    print("Service discovery: GetCapabilities (fallback)")
+    print("Available capabilities:", client.capabilities)
+else:
+    print("Service discovery: Using default URLs")
 ```
 
-**Get detailed service information with capabilities:**
+**Why this approach?**
 
-If you need detailed capability information for each service, call `GetServices` with `IncludeCapability=True`:
+- **GetServices** provides the most accurate and detailed service information, but it's **optional** in the ONVIF specification
+- **GetCapabilities** is **mandatory** for all ONVIF-compliant devices, ensuring broader compatibility
+- **Default URLs** guarantee basic connectivity even with non-compliant devices
+
+**Get detailed service information:**
+
+If you need comprehensive service details, you can manually call `GetServices` with capabilities:
 
 ```python
 device = client.devicemgmt()
-services = device.GetServices(IncludeCapability=True)
-
-for service in services:
-    print(f"Service: {service.Namespace}")
-    print(f"Endpoint: {service.XAddr}")
-    print(f"Version: {service.Version.Major}.{service.Version.Minor}")
-    if hasattr(service, 'Capabilities') and service.Capabilities:
-        print(f"Capabilities: {service.Capabilities}")
+
+try:
+    # Try to get detailed service information
+    services = device.GetServices(IncludeCapability=True)
+    for service in services:
+        print(f"Service: {service.Namespace}")
+        print(f"XAddr: {service.XAddr}")
+        if hasattr(service, 'Capabilities'):
+            print(f"Capabilities: {service.Capabilities}")
+except Exception:
+    # Fallback to GetCapabilities for legacy devices
+    capabilities = device.GetCapabilities()
+    print("Capabilities:", capabilities)
 ```
 
-**Alternative: Use GetCapabilities for legacy compatibility:**
+**Access capabilities information:**
 
-For backward compatibility or when you need a quick overview of major service categories, you can still use `GetCapabilities`:
+When using `GetCapabilities` fallback, you can access capability information:
 
 ```python
-capabilities = client.devicemgmt().GetCapabilities()
-print(capabilities)
-# Example output: {'Media': {'XAddr': '...', ...}, 'PTZ': {...}, 'Events': {...}, ...}
+device = client.devicemgmt()
+
+try:
+    # Get capabilities information from device
+    capabilities = device.GetCapabilities()
+    
+    # Main services (always available)
+    print("Media XAddr:", getattr(capabilities.Media, 'XAddr', 'Not available'))
+    print("PTZ XAddr:", getattr(capabilities.PTZ, 'XAddr', 'Not available'))
+    
+    # Extension services (device-dependent)
+    ext = getattr(capabilities, 'Extension', None)
+    if ext:
+        print("DeviceIO XAddr:", getattr(ext.DeviceIO, 'XAddr', 'Not available'))
+        print("Recording XAddr:", getattr(ext.Recording, 'XAddr', 'Not available'))
+        print("Search XAddr:", getattr(ext.Search, 'XAddr', 'Not available'))
+        print("Replay XAddr:", getattr(ext.Replay, 'XAddr', 'Not available'))
+except Exception as e:
+    print(f"Error getting capabilities: {e}")
 ```
 
 > [!TIP]
-> The library handles service discovery automatically, so you typically don't need to call `GetServices` manually unless you need detailed capability information or want to refresh the service list after device configuration changes.
+> The library handles service discovery automatically with intelligent fallback. You typically don't need to call discovery methods manually unless you need detailed capability information or want to refresh the service list after device configuration changes.
 
 ## Tested Devices
 
@@ -598,8 +645,6 @@ This project is an **independent open-source implementation** of the [ONVIF](htt
 
 If you require certified ONVIF-compliant devices or clients, please refer to the official [ONVIF conformant product list](https://www.onvif.org/conformant-products/). For authoritative reference and the latest official ONVIF specifications, please consult the [ONVIF Official Specifications](https://www.onvif.org/profiles/specifications/specification-history/).
 
-Use of this library is at your own risk. The authors and contributors assume no liability for any damages, direct or indirect, arising from its use.
-
 ## License
 
 This project is licensed under the MIT License. See [LICENSE](./LICENSE.md) for details.

{onvif_python-0.0.7 → onvif_python-0.0.9}/README.md

@@ -2,14 +2,11 @@
 
 [![License](https://img.shields.io/badge/License-MIT-blue)](https://github.com/nirsimetri/onvif-python?tab=MIT-1-ov-file)
 [![DeepWiki](https://img.shields.io/badge/DeepWiki-AI%20Wiki-orange)](https://deepwiki.com/nirsimetri/onvif-python)
-[![Release](https://img.shields.io/badge/Release-v0.0.7-red?logo=archive)](https://github.com/nirsimetri/onvif-python/releases)
+[![Release](https://img.shields.io/badge/Release-v0.0.9-red?logo=archive)](https://github.com/nirsimetri/onvif-python/releases)
 <br>
-[![PyPI](https://img.shields.io/badge/PyPI-0.0.7-yellow?logo=archive)](https://pypi.org/project/onvif-python/)
+[![PyPI](https://img.shields.io/badge/PyPI-0.0.9-yellow?logo=archive)](https://pypi.org/project/onvif-python/)
 [![Downloads](https://img.shields.io/pypi/dm/onvif-python?label=PyPI%20Downloads)](https://clickpy.clickhouse.com/dashboard/onvif-python)
 
-Are you having trouble finding a Python ONVIF library that supports your device?  
-Are you confused about the compatibility of the various ONVIF versions, which are updated every six months?
-
 **This project provides a comprehensive and developer-friendly Python library for working with ONVIF-compliant devices.** It is designed to be reliable, easy to integrate, and flexible enough to support a wide range of ONVIF profiles and services.  
 
 **[ONVIF](https://www.onvif.org) (Open Network Video Interface Forum)** is a global standard for the interface of IP-based physical security products, including network cameras, video recorders, and related systems.  
@@ -113,7 +110,9 @@ Explore more advanced usage and service-specific operations in the [`examples/`]
 
 The `ONVIFClient` class provides various configuration options to customize the connection behavior, caching strategy, security settings, and debugging capabilities. Below is a detailed description of all available parameters:
 
-### Basic Parameters
+
+<details>
+<summary><b>Basic Parameters</b></summary>
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
@@ -122,7 +121,10 @@ The `ONVIFClient` class provides various configuration options to customize the
 | `username` | `str` | ✅ Yes | - | Username for device authentication (use digest authentication) |
 | `password` | `str` | ✅ Yes | - | Password for device authentication |
 
-### Connection Parameters
+</details>
+
+<details>
+<summary><b>Connection Parameters</b></summary>
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
@@ -130,33 +132,45 @@ The `ONVIFClient` class provides various configuration options to customize the
 | `use_https` | `bool` | ❌ No | `False` | Use HTTPS instead of HTTP for secure communication |
 | `verify_ssl` | `bool` | ❌ No | `True` | Verify SSL certificates when using HTTPS (set to `False` for self-signed certificates) |
 
-### Caching Parameters
+</details>
+
+<details>
+<summary><b>Caching Parameters</b></summary>
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
 | `cache` | `CacheMode` | ❌ No | `CacheMode.ALL` | WSDL caching strategy (see [Cache Modes](#cache-modes) below) |
 
-### Feature Parameters
+</details>
+
+<details>
+<summary><b>Feature Parameters</b></summary>
 
 | Parameter | Type | Required | Default | Description |
 |-----------|------|----------|---------|-------------|
-| `apply_patch` | `bool` | ❌ No | `True` | Enable zeep patching for better xsd:any field parsing and automatic flattening |
+| `apply_patch` | `bool` | ❌ No | `True` | Enable zeep patching for better `xsd:any` field parsing and automatic flattening |
 | `capture_xml` | `bool` | ❌ No | `False` | Enable XML capture plugin for debugging SOAP requests/responses |
 
-### Cache Modes
+</details>
+
+<details>
+<summary><b>Cache Modes</b></summary> 
 
 The library provides four caching strategies via the `CacheMode` enum:
 
 | Mode | Description | Best For | Startup Speed | Disk Usage | Memory Usage |
 |------|-------------|----------|---------------|------------|--------------|
-| `CacheMode.ALL` | In-memory + disk cache (SQLite) | Production servers, multi-device apps | ⚡⚡⚡ Fast | 💾 High | 🧠 High |
-| `CacheMode.DB` | Disk cache only (SQLite) | Batch jobs, CLI tools | ⚡⚡ Medium | 💾 Medium | 🧠 Low |
-| `CacheMode.MEM` | In-memory cache only | Short-lived scripts, demos | ⚡⚡ Medium | 💾 None | 🧠 Medium |
-| `CacheMode.NONE` | No caching | Testing, debugging | ⚡ Slow | 💾 None | 🧠 Low |
+| `CacheMode.ALL` | In-memory + disk cache (SQLite) | Production servers, multi-device apps | Fast | High | High |
+| `CacheMode.DB` | Disk cache only (SQLite) | Batch jobs, CLI tools | Medium | Medium | Low |
+| `CacheMode.MEM` | In-memory cache only | Short-lived scripts, demos | Medium | None | Medium |
+| `CacheMode.NONE` | No caching | Testing, debugging | Slow | None | Low |
 
 **Recommendation:** Use `CacheMode.ALL` (default) for production applications to maximize performance.
 
-### Usage Examples
+</details>
+
+<details>
+<summary><b>Usage Examples</b></summary>
 
 **Basic Connection:**
 ```python
@@ -177,8 +191,7 @@ client = ONVIFClient(
     "admin", 
     "password",
     timeout=30,
-    use_https=True,
-    verify_ssl=False  # For self-signed certificates
+    use_https=True
 )
 ```
 
@@ -196,7 +209,7 @@ client = ONVIFClient(
 )
 ```
 
-**No Caching (Testing):**
+**No Caching and No Zeep Patching (Testing):**
 ```python
 from onvif import ONVIFClient, CacheMode
 
@@ -255,7 +268,6 @@ if client.xml_plugin:
     client.xml_plugin.clear_history()
 ```
 
-> [!NOTE]
 > **XML Capture Plugin Methods:**
 > - `last_sent_xml` - Get the last SOAP request XML
 > - `last_received_xml` - Get the last SOAP response XML
@@ -267,8 +279,11 @@ if client.xml_plugin:
 > - `save_to_file(request_file, response_file)` - Save XML to files
 > - `clear_history()` - Clear captured history
 
+</details>
+
+<details>
+<summary><b>Production Configuration</b></summary>
 
-**Production Configuration:**
 ```python
 from onvif import ONVIFClient, CacheMode
 
@@ -279,13 +294,14 @@ client = ONVIFClient(
     username="admin",
     password="secure_password",
     timeout=15,
-    cache=CacheMode.ALL,        # Maximum performance
+    cache=CacheMode.ALL,        # Maximum performance (default)
     use_https=True,             # Secure communication
     verify_ssl=True,            # Verify certificates (default)
     apply_patch=True,           # Enhanced parsing (default)
     capture_xml=False           # Disable debug mode (default)
 )
 ```
+</details>
 
 ### Notes
 
@@ -297,7 +313,7 @@ client = ONVIFClient(
 ## Service Discovery: Understanding Device Capabilities
 
 > [!WARNING]
-> Before performing any operations on an ONVIF device, it is highly recommended to discover which services are available and supported by the device. This library automatically uses `GetServices` during initialization to discover service endpoints, but you can also query services manually for detailed information including capabilities.
+> Before performing any operations on an ONVIF device, it is highly recommended to discover which services are available and supported by the device. This library automatically performs comprehensive service discovery during initialization using a robust fallback mechanism.
 
 **Why discover device services?**
 
@@ -308,50 +324,84 @@ client = ONVIFClient(
 
 **How service discovery works in this library:**
 
-The `ONVIFClient` automatically calls `GetServices` during initialization to build a service map. This map is used internally to resolve service endpoints:
+The `ONVIFClient` uses a **3-tier discovery approach** to maximize device compatibility:
+
+1. **GetServices (Preferred)** - Tries `GetServices` first for detailed service information
+2. **GetCapabilities (Fallback)** - Falls back to `GetCapabilities` if `GetServices` is not supported
+3. **Default URLs (Final Fallback)** - Uses standard ONVIF URLs as last resort
 
 ```python
 from onvif import ONVIFClient
 
 client = ONVIFClient("192.168.1.17", 8000, "admin", "admin123")
 
-# Access the discovered services
-print(client.services)
-# Example output: [{'Namespace': 'http://www.onvif.org/ver10/device/wsdl', 'XAddr': '...', 'Version': {...}}, ...]
-
-# Check the service map (namespace -> XAddr mapping)
-print(client._service_map)
-# Example output: {'http://www.onvif.org/ver10/media/wsdl': 'http://192.168.1.17:8000/onvif/Media', ...}
+# Check what discovery method was used
+if client.services:
+    print("Service discovery: GetServices (preferred)")
+    print("Discovered services:", len(client.services))
+    print("Service map:", client._service_map)
+elif client.capabilities:
+    print("Service discovery: GetCapabilities (fallback)")
+    print("Available capabilities:", client.capabilities)
+else:
+    print("Service discovery: Using default URLs")
 ```
 
-**Get detailed service information with capabilities:**
+**Why this approach?**
 
-If you need detailed capability information for each service, call `GetServices` with `IncludeCapability=True`:
+- **GetServices** provides the most accurate and detailed service information, but it's **optional** in the ONVIF specification
+- **GetCapabilities** is **mandatory** for all ONVIF-compliant devices, ensuring broader compatibility
+- **Default URLs** guarantee basic connectivity even with non-compliant devices
+
+**Get detailed service information:**
+
+If you need comprehensive service details, you can manually call `GetServices` with capabilities:
 
 ```python
 device = client.devicemgmt()
-services = device.GetServices(IncludeCapability=True)
-
-for service in services:
-    print(f"Service: {service.Namespace}")
-    print(f"Endpoint: {service.XAddr}")
-    print(f"Version: {service.Version.Major}.{service.Version.Minor}")
-    if hasattr(service, 'Capabilities') and service.Capabilities:
-        print(f"Capabilities: {service.Capabilities}")
+
+try:
+    # Try to get detailed service information
+    services = device.GetServices(IncludeCapability=True)
+    for service in services:
+        print(f"Service: {service.Namespace}")
+        print(f"XAddr: {service.XAddr}")
+        if hasattr(service, 'Capabilities'):
+            print(f"Capabilities: {service.Capabilities}")
+except Exception:
+    # Fallback to GetCapabilities for legacy devices
+    capabilities = device.GetCapabilities()
+    print("Capabilities:", capabilities)
 ```
 
-**Alternative: Use GetCapabilities for legacy compatibility:**
+**Access capabilities information:**
 
-For backward compatibility or when you need a quick overview of major service categories, you can still use `GetCapabilities`:
+When using `GetCapabilities` fallback, you can access capability information:
 
 ```python
-capabilities = client.devicemgmt().GetCapabilities()
-print(capabilities)
-# Example output: {'Media': {'XAddr': '...', ...}, 'PTZ': {...}, 'Events': {...}, ...}
+device = client.devicemgmt()
+
+try:
+    # Get capabilities information from device
+    capabilities = device.GetCapabilities()
+    
+    # Main services (always available)
+    print("Media XAddr:", getattr(capabilities.Media, 'XAddr', 'Not available'))
+    print("PTZ XAddr:", getattr(capabilities.PTZ, 'XAddr', 'Not available'))
+    
+    # Extension services (device-dependent)
+    ext = getattr(capabilities, 'Extension', None)
+    if ext:
+        print("DeviceIO XAddr:", getattr(ext.DeviceIO, 'XAddr', 'Not available'))
+        print("Recording XAddr:", getattr(ext.Recording, 'XAddr', 'Not available'))
+        print("Search XAddr:", getattr(ext.Search, 'XAddr', 'Not available'))
+        print("Replay XAddr:", getattr(ext.Replay, 'XAddr', 'Not available'))
+except Exception as e:
+    print(f"Error getting capabilities: {e}")
 ```
 
 > [!TIP]
-> The library handles service discovery automatically, so you typically don't need to call `GetServices` manually unless you need detailed capability information or want to refresh the service list after device configuration changes.
+> The library handles service discovery automatically with intelligent fallback. You typically don't need to call discovery methods manually unless you need detailed capability information or want to refresh the service list after device configuration changes.
 
 ## Tested Devices
 
@@ -557,8 +607,6 @@ This project is an **independent open-source implementation** of the [ONVIF](htt
 
 If you require certified ONVIF-compliant devices or clients, please refer to the official [ONVIF conformant product list](https://www.onvif.org/conformant-products/). For authoritative reference and the latest official ONVIF specifications, please consult the [ONVIF Official Specifications](https://www.onvif.org/profiles/specifications/specification-history/).
 
-Use of this library is at your own risk. The authors and contributors assume no liability for any damages, direct or indirect, arising from its use.
-
 ## License
 
 This project is licensed under the MIT License. See [LICENSE](./LICENSE.md) for details.