Skip to content

Commit 8604eaf

Browse files
committed
docs(readme): Remove detailed service information and capability access examples for clarity
1 parent e79e55c commit 8604eaf

2 files changed

Lines changed: 0 additions & 94 deletions

File tree

‎README.md‎

Lines changed: 0 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -397,53 +397,6 @@ else:
397397
- **GetCapabilities** is **mandatory** for all ONVIF-compliant devices, ensuring broader compatibility
398398
- **Default URLs** guarantee basic connectivity even with non-compliant devices
399399

400-
**Get detailed service information:**
401-
402-
If you need comprehensive service details, you can manually call `GetServices` with capabilities:
403-
404-
```python
405-
device = client.devicemgmt()
406-
407-
try:
408-
# Try to get detailed service information
409-
services = device.GetServices(IncludeCapability=True)
410-
for service in services:
411-
print(f"Service: {service.Namespace}")
412-
print(f"XAddr: {service.XAddr}")
413-
if hasattr(service, 'Capabilities'):
414-
print(f"Capabilities: {service.Capabilities}")
415-
except Exception:
416-
# Fallback to GetCapabilities for legacy devices
417-
capabilities = device.GetCapabilities()
418-
print("Capabilities:", capabilities)
419-
```
420-
421-
**Access capabilities information:**
422-
423-
When using `GetCapabilities` fallback, you can access capability information:
424-
425-
```python
426-
device = client.devicemgmt()
427-
428-
try:
429-
# Get capabilities information from device
430-
capabilities = device.GetCapabilities()
431-
432-
# Main services (always available)
433-
print("Media XAddr:", getattr(capabilities.Media, 'XAddr', 'Not available'))
434-
print("PTZ XAddr:", getattr(capabilities.PTZ, 'XAddr', 'Not available'))
435-
436-
# Extension services (device-dependent)
437-
ext = getattr(capabilities, 'Extension', None)
438-
if ext:
439-
print("DeviceIO XAddr:", getattr(ext.DeviceIO, 'XAddr', 'Not available'))
440-
print("Recording XAddr:", getattr(ext.Recording, 'XAddr', 'Not available'))
441-
print("Search XAddr:", getattr(ext.Search, 'XAddr', 'Not available'))
442-
print("Replay XAddr:", getattr(ext.Replay, 'XAddr', 'Not available'))
443-
except Exception as e:
444-
print(f"Error getting capabilities: {e}")
445-
```
446-
447400
> [!TIP]
448401
> 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.
449402

‎README_ID.md‎

Lines changed: 0 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -396,53 +396,6 @@ else:
396396
- **GetCapabilities** bersifat **wajib** untuk semua perangkat yang sesuai dengan ONVIF, memastikan kompatibilitas yang lebih luas
397397
- **URL Default** menjamin konektivitas dasar bahkan dengan perangkat yang tidak sesuai
398398

399-
**Dapatkan informasi layanan detail:**
400-
401-
Jika Anda memerlukan detail layanan yang komprehensif, Anda dapat memanggil `GetServices` secara manual dengan kapabilitas:
402-
403-
```python
404-
device = client.devicemgmt()
405-
406-
try:
407-
# Coba dapatkan informasi layanan detail
408-
services = device.GetServices(IncludeCapability=True)
409-
for service in services:
410-
print(f"Layanan: {service.Namespace}")
411-
print(f"XAddr: {service.XAddr}")
412-
if hasattr(service, 'Capabilities'):
413-
print(f"Kapabilitas: {service.Capabilities}")
414-
except Exception:
415-
# Fallback ke GetCapabilities untuk perangkat legacy
416-
capabilities = device.GetCapabilities()
417-
print("Kapabilitas:", capabilities)
418-
```
419-
420-
**Akses informasi kapabilitas:**
421-
422-
Saat menggunakan fallback `GetCapabilities`, Anda dapat mengakses informasi kapabilitas:
423-
424-
```python
425-
device = client.devicemgmt()
426-
427-
try:
428-
# Dapatkan informasi kapabilitas dari perangkat
429-
capabilities = device.GetCapabilities()
430-
431-
# Layanan utama (selalu tersedia)
432-
print("Media XAddr:", getattr(capabilities.Media, 'XAddr', 'Tidak tersedia'))
433-
print("PTZ XAddr:", getattr(capabilities.PTZ, 'XAddr', 'Tidak tersedia'))
434-
435-
# Layanan Extension (tergantung perangkat)
436-
ext = getattr(capabilities, 'Extension', None)
437-
if ext:
438-
print("DeviceIO XAddr:", getattr(ext.DeviceIO, 'XAddr', 'Tidak tersedia'))
439-
print("Recording XAddr:", getattr(ext.Recording, 'XAddr', 'Tidak tersedia'))
440-
print("Search XAddr:", getattr(ext.Search, 'XAddr', 'Tidak tersedia'))
441-
print("Replay XAddr:", getattr(ext.Replay, 'XAddr', 'Tidak tersedia'))
442-
except Exception as e:
443-
print(f"Error mendapatkan kapabilitas: {e}")
444-
```
445-
446399
> [!TIP]
447400
> Pustaka menangani penemuan layanan secara otomatis dengan fallback yang cerdas. Anda biasanya tidak perlu memanggil metode penemuan secara manual kecuali Anda memerlukan informasi kapabilitas detail atau ingin menyegarkan daftar layanan setelah perubahan konfigurasi perangkat.
448401

0 commit comments

Comments
 (0)