onvif-python 0.2.4__py3-none-any.whl → 0.2.6__py3-none-any.whl

onvif/__init__.py

@@ -1,7 +1,7 @@
 # onvif/__init__.py
 
 from .client import ONVIFClient
-from .operator import ONVIFOperator, CacheMode
+from .operator import CacheMode
 from .utils import (
     ONVIFWSDL,
     ONVIFOperationException,
@@ -14,7 +14,6 @@ from .cli import main as ONVIFCLI
 
 __all__ = [
     "ONVIFClient",
-    "ONVIFOperator",
     "CacheMode",
     "ONVIFWSDL",
     "ONVIFOperationException",

onvif/cli/interactive.py

@@ -194,7 +194,7 @@ class InteractiveShell(cmd.Cmd):
             "  / __ \\/ | / / |  / /  _/ ____/",
             " / / / /  |/ /| | / // // /_    ",
             "/ /_/ / /|  / | |/ // // __/    ",
-            "\\____/_/ |_/  |___/___/_/  v0.2.4",
+            "\\____/_/ |_/  |___/___/_/  v0.2.6",
             "                                ",
         ]
 
@@ -1400,7 +1400,7 @@ class InteractiveShell(cmd.Cmd):
             super().do_help(line)
         else:
             help_text = f"""
-{colorize('ONVIF Interactive Shell — v0.2.4', 'cyan')}\n{colorize('https://github.com/nirsimetri/onvif-python', 'white')}
+{colorize('ONVIF Interactive Shell — v0.2.6', 'cyan')}\n{colorize('https://github.com/nirsimetri/onvif-python', 'white')}
 
 {colorize('Basic Commands:', 'yellow')}
   capabilities, caps       - Show device capabilities

onvif/cli/main.py

@@ -7,6 +7,7 @@ import getpass
 import sqlite3
 import os
 import shutil
+import json
 from datetime import datetime
 from typing import Any, Optional, Tuple
 
@@ -21,7 +22,7 @@ def create_parser():
     """Create argument parser for ONVIF CLI"""
     parser = argparse.ArgumentParser(
         prog="onvif",
-        description=f"{colorize('ONVIF Terminal Client', 'yellow')} — v0.2.4\nhttps://github.com/nirsimetri/onvif-python",
+        description=f"{colorize('ONVIF Terminal Client', 'yellow')} — v0.2.6\nhttps://github.com/nirsimetri/onvif-python",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog=f"""
 Examples:
@@ -42,7 +43,12 @@ Examples:
 
   # Direct command execution
   {colorize('onvif', 'yellow')} devicemgmt GetCapabilities Category=All --host 192.168.1.17 --port 8000 --username admin --password admin123
-  {colorize('onvif', 'yellow')} ptz ContinuousMove ProfileToken=Profile_1 Velocity={{"PanTilt": {{"x": -0.1, "y": 0}}}} --host 192.168.1.17 --port 8000 --username admin --password admin123
+  {colorize('onvif', 'yellow')} ptz ContinuousMove ProfileToken=Profile_1 Velocity={{'PanTilt': {{'x': -0.1, 'y': 0}}}} -H 192.168.1.17 -P 8000 -u admin -p admin123
+
+  # Save output to file
+  {colorize('onvif', 'yellow')} devicemgmt GetDeviceInformation --host 192.168.1.17 --port 8000 --username admin --password admin123 --output device_info.json
+  {colorize('onvif', 'yellow')} media GetProfiles --host 192.168.1.17 --port 8000 --username admin --password admin123 --output profiles.xml
+  {colorize('onvif', 'yellow')} ptz GetConfigurations --host 192.168.1.17 --port 8000 --username admin --password admin123 --output ptz_config.txt --debug
 
   # Interactive mode
   {colorize('onvif', 'yellow')} --host 192.168.1.17 --port 8000 --username admin --password admin123 --interactive
@@ -139,6 +145,11 @@ Examples:
         default=10,
         help="Health check interval in seconds for interactive mode (default: 10)",
     )
+    parser.add_argument(
+        "--output",
+        "-o",
+        help="Save command output to file. Supports .json, .xml extensions for format detection, or plain text. XML format automatically enables debug mode for SOAP capture.",
+    )
 
     # Service and method (for direct command execution)
     parser.add_argument(
@@ -177,7 +188,7 @@ def main():
 
     # Show ONVIF CLI version
     if args.version:
-        print(colorize("0.2.4", "yellow"))
+        print(colorize("0.2.6", "yellow"))
         sys.exit(0)
 
     # Handle product search
@@ -196,6 +207,12 @@ def main():
             f"Either {colorize('--interactive', 'white')}/{colorize('-i', 'white')} mode or {colorize('service/method', 'white')} must be specified"
         )
 
+    # Validate output argument
+    if args.output and args.interactive:
+        parser.error(
+            f"{colorize('--output', 'white')} cannot be used with {colorize('--interactive', 'white')} mode"
+        )
+
     # Handle discovery mode
     if args.discover:
         if args.host:
@@ -260,6 +277,11 @@ def main():
 
     try:
         # Create ONVIF client
+        # Auto-enable debug mode if output format is XML
+        auto_debug = args.debug or (
+            args.output and args.output.lower().endswith(".xml")
+        )
+
         client = ONVIFClient(
             host=args.host,
             port=args.port,
@@ -270,7 +292,7 @@ def main():
             use_https=args.https,
             verify_ssl=not args.no_verify,
             apply_patch=not args.no_patch,
-            capture_xml=args.debug,
+            capture_xml=auto_debug,
             wsdl_dir=args.wsdl,
         )
 
@@ -298,7 +320,17 @@ def main():
             # Execute direct command
             params_str = " ".join(args.params) if args.params else None
             result = execute_command(client, args.service, args.method, params_str)
-            print(str(result))
+
+            # Save output to file if specified
+            if args.output:
+                # Auto-enable debug mode for XML output
+                effective_debug = args.debug or args.output.lower().endswith(".xml")
+                save_output_to_file(result, args.output, effective_debug, client)
+                print(
+                    f"{colorize('Output saved to:', 'green')} {colorize(args.output, 'white')}"
+                )
+            else:
+                print(str(result))
 
     except KeyboardInterrupt:
         print("\nOperation cancelled by user")
@@ -337,6 +369,182 @@ def execute_command(
     return method(**params)
 
 
+def save_output_to_file(
+    result: Any, output_path: str, debug_mode: bool, client: ONVIFClient
+) -> None:
+    """Save command output to file in appropriate format based on file extension.
+
+    Args:
+        result: The ONVIF command result
+        output_path: Path to output file
+        debug_mode: Whether debug mode is enabled (for XML capture)
+        client: ONVIFClient instance (for accessing XML plugin)
+    """
+    try:
+        # Determine output format based on file extension
+        _, ext = os.path.splitext(output_path.lower())
+
+        if ext == ".json":
+            # Prepare output data
+            output_data = {}
+
+            # JSON format
+            output_data["result"] = _serialize_for_json(result)
+            output_data["timestamp"] = datetime.now().isoformat()
+            output_data["raw_result"] = str(result)  # Add raw string as fallback
+
+            # Add XML data if debug mode is enabled and XML plugin is available
+            if debug_mode and client.xml_plugin:
+                output_data["debug"] = {
+                    "last_request_xml": client.xml_plugin.last_sent_xml,
+                    "last_response_xml": client.xml_plugin.last_received_xml,
+                    "last_operation": client.xml_plugin.last_operation,
+                }
+
+            with open(output_path, "w", encoding="utf-8") as f:
+                json.dump(output_data, f, indent=2, ensure_ascii=False)
+
+        elif ext == ".xml":
+            # XML format - prioritize raw SOAP XML over parsed result
+            if client.xml_plugin and client.xml_plugin.last_received_xml:
+                # Save the raw SOAP response XML with minimal wrapper
+                content = f"""<?xml version="1.0" encoding="UTF-8"?>
+<!-- ONVIF SOAP Response -->
+<!-- Timestamp: {datetime.now().isoformat()} -->
+<!-- Operation: {client.xml_plugin.last_operation or 'Unknown'} -->
+
+{client.xml_plugin.last_received_xml}
+"""
+            else:
+                # Fallback: Simple XML wrapper for the parsed result
+                content = f"""<?xml version="1.0" encoding="UTF-8"?>
+<!-- ONVIF Command Output (Parsed Result) -->
+<!-- Timestamp: {datetime.now().isoformat()} -->
+<!-- Note: Raw SOAP XML not available. Enable --debug for full SOAP capture. -->
+<onvif_result>
+<![CDATA[
+{str(result)}
+]]>
+</onvif_result>
+"""
+
+            with open(output_path, "w", encoding="utf-8") as f:
+                f.write(content)
+
+        else:
+            # Plain text format (default)
+            content = "ONVIF Command Output\n"
+            content += f"Timestamp: {datetime.now().isoformat()}\n"
+            content += f"{'='*50}\n\n"
+            content += str(result)
+
+            # Add debug information if available
+            if debug_mode and client.xml_plugin:
+                content += f"\n\n{'='*50}\n"
+                content += "DEBUG INFORMATION\n"
+                content += f"{'='*50}\n"
+                if client.xml_plugin.last_operation:
+                    content += f"Operation: {client.xml_plugin.last_operation}\n\n"
+                if client.xml_plugin.last_sent_xml:
+                    content += "SOAP Request:\n"
+                    content += client.xml_plugin.last_sent_xml + "\n\n"
+                if client.xml_plugin.last_received_xml:
+                    content += "SOAP Response:\n"
+                    content += client.xml_plugin.last_received_xml + "\n"
+
+            with open(output_path, "w", encoding="utf-8") as f:
+                f.write(content)
+
+    except Exception as e:
+        print(f"{colorize('Error saving output:', 'red')} {e}", file=sys.stderr)
+        # Still print the result to console if file save fails
+        print(str(result))
+
+
+def _serialize_for_json(obj: Any) -> Any:
+    """Recursively serialize ONVIF objects for JSON output.
+
+    Args:
+        obj: Object to serialize
+
+    Returns:
+        JSON-serializable representation of the object
+    """
+    if obj is None:
+        return None
+    elif isinstance(obj, (str, int, float, bool)):
+        return obj
+    elif isinstance(obj, datetime):
+        return obj.isoformat()
+    elif isinstance(obj, (list, tuple)):
+        return [_serialize_for_json(item) for item in obj]
+    elif isinstance(obj, dict):
+        return {key: _serialize_for_json(value) for key, value in obj.items()}
+
+    # Check if this is a Zeep object (has _xsd_type attribute)
+    elif hasattr(obj, "_xsd_type"):
+        result = {}
+        # Try to get all elements from XSD type
+        if hasattr(obj._xsd_type, "elements"):
+            for elem_name, elem_obj in obj._xsd_type.elements:
+                try:
+                    value = getattr(obj, elem_name, None)
+                    if value is not None:
+                        result[elem_name] = _serialize_for_json(value)
+                except (AttributeError, TypeError):
+                    # Skip elements that can't be accessed or have type issues
+                    pass
+
+        # Also try regular attributes
+        for attr_name in dir(obj):
+            if not attr_name.startswith("_") and not callable(
+                getattr(obj, attr_name, None)
+            ):
+                try:
+                    attr_value = getattr(obj, attr_name)
+                    if attr_value is not None and attr_name not in result:
+                        result[attr_name] = _serialize_for_json(attr_value)
+                except (AttributeError, TypeError):
+                    # Skip attributes that can't be accessed or have type issues
+                    pass
+
+        return result
+
+    elif hasattr(obj, "__dict__"):
+        # Handle regular objects with attributes
+        result = {}
+        for key, value in obj.__dict__.items():
+            if not key.startswith("_"):  # Skip private attributes
+                result[key] = _serialize_for_json(value)
+
+        # If result is empty, try to get attributes using dir()
+        if not result:
+            for attr_name in dir(obj):
+                if not attr_name.startswith("_") and not callable(
+                    getattr(obj, attr_name, None)
+                ):
+                    try:
+                        attr_value = getattr(obj, attr_name)
+                        if attr_value is not None:
+                            result[attr_name] = _serialize_for_json(attr_value)
+                    except (AttributeError, TypeError):
+                        # Skip attributes that can't be accessed or have type issues
+                        pass
+
+        return result
+    elif hasattr(obj, "_value_1"):
+        # Handle zeep objects with special structure
+        return _serialize_for_json(obj._value_1)
+    else:
+        # Try to convert to dict using vars() if available
+        try:
+            obj_dict = vars(obj)
+            return _serialize_for_json(obj_dict)
+        except TypeError:
+            # Fallback to string representation
+            return str(obj)
+
+
 def discover_devices(
     timeout: int = 4, prefer_https: bool = False, filter_term: Optional[str] = None
 ) -> list:

onvif/services/devicemgmt.py

@@ -411,3 +411,6 @@ class Device(ONVIFService):
 
     def SetHashingAlgorithm(self, Algorithm):
         return self.operator.call("SetHashingAlgorithm", Algorithm=Algorithm)
+
+    def UpgradeFirmware(self, Version):
+        return self.operator.call("UpgradeFirmware", Version=Version)

onvif/services/media2.py

@@ -313,3 +313,20 @@ class Media2(ONVIFService):
 
     def GetPlayingAudioClips(self):
         return self.operator.call("GetPlayingAudioClips")
+
+    def GetMulticastAudioDecoderConfigurationOptions(self, ConfigurationToken=None):
+        return self.operator.call(
+            "GetMulticastAudioDecoderConfigurationOptions",
+            ConfigurationToken=ConfigurationToken,
+        )
+
+    def GetMulticastAudioDecoderConfigurations(self, ConfigurationToken=None):
+        return self.operator.call(
+            "GetMulticastAudioDecoderConfigurations",
+            ConfigurationToken=ConfigurationToken,
+        )
+
+    def SetMulticastAudioDecoderConfiguration(self, Configuration):
+        return self.operator.call(
+            "SetMulticastAudioDecoderConfiguration", Configuration=Configuration
+        )

onvif/wsdl/ver10/advancedsecurity/wsdl/advancedsecurity.wsdl

@@ -82,7 +82,7 @@
 					</xs:enumeration>
 				</xs:restriction>
 			</xs:simpleType>
-			<xs:simpleType name="KeyAlgorithm">
+			<xs:simpleType name="KeyPairAlgorithm">
 				<xs:restriction base="xs:string">
 					<xs:enumeration value="RSA"/>
 					<xs:enumeration value="ECC"/>
@@ -740,12 +740,12 @@
 				</xs:attribute>
 				<xs:attribute name="RSAKeyPairGeneration" type="xs:boolean">
 					<xs:annotation>
-						<xs:documentation>Indication that the device supports on-board RSA key pair generation.</xs:documentation>
+						<xs:documentation>Deprecated - Indication that the device supports on-board ECC key pair generation.</xs:documentation>
 					</xs:annotation>
 				</xs:attribute>
 				<xs:attribute name="ECCKeyPairGeneration" type="xs:boolean">
 					<xs:annotation>
-						<xs:documentation>Indication that the device supports on-board ECC key pair generation.</xs:documentation>
+						<xs:documentation>Deprecated - Indication that the device supports on-board ECC key pair generation.</xs:documentation>
 					</xs:annotation>
 				</xs:attribute>
 				<xs:attribute name="KeyPairGeneration" type="tt:StringList">
@@ -760,12 +760,12 @@
 				</xs:attribute>
 				<xs:attribute name="EllipticCurves" type="tas:EllipticCurves">
 					<xs:annotation>
-						<xs:documentation>Indicates which elliptic curves are supported by the device.</xs:documentation>
+						<xs:documentation>Indicates which elliptic curves are supported by the device. Supported curve names can be found in the IANA TLS Supported Groups section, under the Description field.</xs:documentation>
 					</xs:annotation>
 				</xs:attribute>
 				<xs:attribute name="PKCS10ExternalCertificationWithRSA" type="xs:boolean">
 					<xs:annotation>
-						<xs:documentation>Indicates support for creating PKCS#10 requests for RSA keys and uploading the certificate obtained from a CA..</xs:documentation>
+						<xs:documentation>Deprecated - Indicates support for creating PKCS#10 requests for RSA keys and uploading the certificate obtained from a CA..</xs:documentation>
 					</xs:annotation>
 				</xs:attribute>
 				<xs:attribute name="PKCS10" type="xs:boolean">
@@ -775,7 +775,7 @@
 				</xs:attribute>
 				<xs:attribute name="SelfSignedCertificateCreationWithRSA" type="xs:boolean">
 					<xs:annotation>
-						<xs:documentation>Indicates support for creating self-signed certificates for RSA keys.</xs:documentation>
+						<xs:documentation>Deprecated - Indicates support for creating self-signed certificates for RSA keys.</xs:documentation>
 					</xs:annotation>
 				</xs:attribute>
 				<xs:attribute name="SelfSignedCertificateCreation" type="xs:boolean">
@@ -795,7 +795,7 @@
 				</xs:attribute>
 				<xs:attribute name="PKCS8RSAKeyPairUpload" type="xs:boolean">
 					<xs:annotation>
-						<xs:documentation>Indicates support for uploading an RSA key pair in a PKCS#8 data structure.</xs:documentation>
+						<xs:documentation>Deprecated - Indicates support for uploading an RSA key pair in a PKCS#8 data structure.</xs:documentation>
 					</xs:annotation>
 				</xs:attribute>
 				<xs:attribute name="PKCS8" type="xs:boolean">
@@ -805,7 +805,7 @@
 				</xs:attribute>
 				<xs:attribute name="PKCS12CertificateWithRSAPrivateKeyUpload" type="xs:boolean">
 					<xs:annotation>
-						<xs:documentation>Indicates support for uploading a certificate along with an RSA private key in a PKCS#12 data structure.</xs:documentation>
+						<xs:documentation>Deprecated - Indicates support for uploading a certificate along with an RSA private key in a PKCS#12 data structure.</xs:documentation>
 					</xs:annotation>
 				</xs:attribute>
 				<xs:attribute name="PKCS12" type="xs:boolean">
@@ -2967,7 +2967,7 @@
 		</wsdl:operation>
 		<wsdl:operation name="UploadKeyPairInPKCS8">
 			<wsdl:documentation>
-        This operation uploads a key pair in a PKCS#8 data structure as specified in [RFC 5958, RFC 5959].<br/>
+        Deprecated method for uploading a key pair in a PKCS#8 data structure as specified in [RFC 5958, RFC 5959].<br/>
         If an encryption passphrase ID is supplied in the request, the device shall assume that the KeyPair parameter contains an EncryptedPrivateKeyInfo ASN.1
         structure that is encrypted under the passphrase in the keystore that corresponds to the supplied ID, where the EncryptedPrivateKeyInfo structure contains
         both the private key and the corresponding public key. If no encryption passphrase ID is supplied, the device shall assume that the KeyPair parameter contains a

onvif/wsdl/ver10/device/wsdl/devicemgmt.wsdl

@@ -306,6 +306,11 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 						<xs:documentation>Indicates support for firmware upgrade through MTOM.</xs:documentation>
 					</xs:annotation>
 				</xs:attribute>
+				<xs:attribute name="CloudFirmwareUpgrade" type="xs:boolean">
+					<xs:annotation>
+						<xs:documentation>Indicates support for firmware upgrade through the cloud.</xs:documentation>
+					</xs:annotation>
+				</xs:attribute>
 				<xs:attribute name="HttpFirmwareUpgrade" type="xs:boolean">
 					<xs:annotation>
 						<xs:documentation>Indicates support for firmware upgrade through HTTP.</xs:documentation>
@@ -2118,6 +2123,21 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 				</xs:complexType>
 			</xs:element>
 			<!--===============================-->
+			<xs:element name="UpgradeFirmware">
+				<xs:complexType>
+					<xs:sequence>
+						<xs:element name="Version" type="xs:string"/>
+					</xs:sequence>
+				</xs:complexType>
+			</xs:element>
+			<xs:element name="UpgradeFirmwareResponse">
+				<xs:complexType>
+					<xs:sequence>
+						<xs:element name="ExpectedDownTime" type="xs:duration"/>
+					</xs:sequence>
+				</xs:complexType>
+			</xs:element>
+			<!--===============================-->
 			<xs:element name="StartSystemRestore">
 				<xs:complexType>
 					<xs:sequence/>
@@ -2959,6 +2979,12 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 	<wsdl:message name="StartFirmwareUpgradeResponse">
 		<wsdl:part name="parameters" element="tds:StartFirmwareUpgradeResponse"/>
 	</wsdl:message>
+	<wsdl:message name="UpgradeFirmwareRequest">
+		<wsdl:part name="parameters" element="tds:UpgradeFirmware"/>
+	</wsdl:message>
+	<wsdl:message name="UpgradeFirmwareResponse">
+		<wsdl:part name="parameters" element="tds:UpgradeFirmwareResponse"/>
+	</wsdl:message>
 	<wsdl:message name="StartSystemRestoreRequest">
 		<wsdl:part name="parameters" element="tds:StartSystemRestore"/>
 	</wsdl:message>
@@ -3553,6 +3579,24 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 			<wsdl:input message="tds:StartFirmwareUpgradeRequest"/>
 			<wsdl:output message="tds:StartFirmwareUpgradeResponse"/>
 		</wsdl:operation>
+		<wsdl:operation name="UpgradeFirmware">
+			<wsdl:documentation>This operation initiates a firmware upgrade using between the device
+				and the MCS, without further actions from the client. Cloud firmware upgrade may be
+				achieved using the following steps:
+				<ol>
+					<li>Client retrieves the list of available firmware versions from the MCS.</li>
+					<li>Client calls UpgradeFirmware, selecting the desired FW version.</li>
+					<li>Device service responds with a downtime value.</li>
+					<li>Device and MCS perform the firmware upgrade procedure without further interaction from the Client</li>
+					<li>Device notifies the Client of the result by emitting the appropriate CloudFirmwareUpgrade event</li>
+				</ol>
+				After applying a firmware upgrade the device shall keep the basic network configuration
+				like IP address, subnet mask and gateway or DHCP settings, as well as all the parameters
+				of the Uplink and Security service unchanged, so that it can connect to the cloud.
+				Additionally a firmware upgrade shall not change user credentials.</wsdl:documentation>
+			<wsdl:input message="tds:UpgradeFirmwareRequest"/>
+			<wsdl:output message="tds:UpgradeFirmwareResponse"/>
+		</wsdl:operation>
 		<wsdl:operation name="StartSystemRestore">
 			<wsdl:documentation>This operation initiates a system restore from backed up configuration data using the HTTP
 				POST mechanism. The response to the command includes an HTTP URL to which the backup
@@ -4523,6 +4567,15 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 				<soap:body use="literal"/>
 			</wsdl:output>
 		</wsdl:operation>
+		<wsdl:operation name="UpgradeFirmware">
+			<soap:operation soapAction="http://www.onvif.org/ver10/device/wsdl/UpgradeFirmware"/>
+			<wsdl:input>
+				<soap:body use="literal"/>
+			</wsdl:input>
+			<wsdl:output>
+				<soap:body use="literal"/>
+			</wsdl:output>
+		</wsdl:operation>
 		<wsdl:operation name="StartSystemRestore">
 			<soap:operation soapAction="http://www.onvif.org/ver10/device/wsdl/StartSystemRestore"/>
 			<wsdl:input>

onvif/wsdl/ver10/schema/metadatastream.xsd

@@ -194,6 +194,8 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 			<xs:enumeration value="LicensePlate"/>
 			<xs:enumeration value="Bike"/>	<!-- any of bicycle, motorcycle, motorbike -->
 			<xs:enumeration value="Barcode"/>
+			<xs:enumeration value="Fire"/>
+			<xs:enumeration value="Smoke"/>
 		</xs:restriction>
 	</xs:simpleType>
 	<xs:simpleType name="ClassType">

onvif/wsdl/ver10/schema/onvif.xsd

@@ -2042,6 +2042,230 @@ decoding .A decoder shall decode every data it receives (according to its capabi
 		</xs:sequence>
 	</xs:complexType>
 	<!--===============================-->
+	<!--     MulticastAudioDecoder     -->
+	<!--===============================-->
+	<xs:complexType name="MulticastAudioDecoderConfiguration">
+		<xs:annotation>
+			<xs:documentation>
+				Configuration for the Multicast Audio Decoder.
+			</xs:documentation>
+		</xs:annotation>
+		<xs:complexContent>
+			<xs:extension base="tt:ConfigurationEntity">
+				<xs:sequence>
+					<xs:element name="Enable" type="xs:boolean">
+						<xs:annotation>
+							<xs:documentation>
+								Indicates whether the Multicast Audio Decoder is enabled or disabled.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="AudioOutputToken" type="tt:ReferenceToken" minOccurs="0" maxOccurs="unbounded">
+						<xs:annotation>
+							<xs:documentation>
+								Token of the physical Audio output. This element is optional and can occur multiple times.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Encoding" type="xs:string">
+						<xs:annotation>
+							<xs:documentation>
+								Specifies the encoding type according to IANA media types.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Bitrate" type="xs:int">
+						<xs:annotation>
+							<xs:documentation>
+								The bitrate of the audio stream in bits per second.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="SamplingRate" type="xs:int">
+						<xs:annotation>
+							<xs:documentation>
+								The sampling rate of the audio stream in kHz.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Multicast" type="tt:MulticastReceiverConfiguration">
+						<xs:annotation>
+							<xs:documentation>
+								Contains configuration details for multicast settings.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="RTPPayloadType" type="xs:int">
+						<xs:annotation>
+							<xs:documentation>
+							Defines the RTP payload type used for the audio stream.
+							To ensure compatibility, it is recommended to use dynamic payload types (96 and above), as specified in RFC 3551.
+							Standard payload types (0-95) should only be used for predefined audio formats matching the audio encoding as defined in 
+							<a href="https://www.iana.org/assignments/rtp-parameters/rtp-parameters.xhtml#rtp-parameters-1">IANA RTP Payload Types</a>, 
+							as using them for non-standard media may lead to unexpected errors or interoperability issues.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="Priority" type="xs:int">
+						<xs:annotation>
+							<xs:documentation>
+								Indicates the priority level when multiple configurations are active. 
+								A higher value signifies a higher priority. If several configurations have the same priority value the order between those configurations is undefined.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="MediaFormatParameters" type="xs:string" minOccurs="0">
+						<xs:annotation>
+							<xs:documentation>
+								Optional media format parameters as specified in SDP, such as:
+								a=fmtp:101 stereo=1; sprop-stereo=1.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:element name="SRTPPreSharedParameters" type="tt:SRTPPreShared" minOccurs="0">
+						<xs:annotation>
+							<xs:documentation>
+								 Optional configuration parameters for SRTP pre-shared key usage, applicable when SRTP is supported. When this configuration is present, RTP packets shall be encrypted.
+							</xs:documentation>
+						</xs:annotation>
+					</xs:element>
+					<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> <!-- first Vendor then ONVIF -->
+				</xs:sequence>
+				<xs:anyAttribute processContents="lax"/>
+			</xs:extension>
+		</xs:complexContent>
+	</xs:complexType>
+	<!--===============================-->
+	<xs:complexType name="SRTPPreShared">
+		<xs:sequence>
+			<xs:element name="SRTPPSK" type="xs:string">
+			<xs:annotation>
+				<xs:documentation>
+				An optional SRTP Pre-Shared Key (PSK) represented as a hexadecimal string.
+				This includes both the SRTP master key, followed by the master salt.
+				The sizes of the key and salt depend on the specified SRTPCryptoPolicy.
+				When this element is specified, RTP packets shall be encrypted.
+				The SRTPPSK shall never be returned on a get method.
+				</xs:documentation>
+			</xs:annotation>
+			</xs:element>
+			<xs:element name="SecureStreamingProtocolAlgorithm" type="xs:string">
+			<xs:annotation>
+				<xs:documentation>
+				Specifies the cryptographic algorithm when using SRTP,
+				selecting from predefined values provided in the GetMulticastAudioDecoderConfigurationOptions response.
+				</xs:documentation>
+			</xs:annotation>
+			</xs:element>
+			<xs:element name="ROCExtMapID" type="xs:int">
+			<xs:annotation>
+				<xs:documentation>
+				The RTP header extension ID (ExtMapID) used to identify the ROC extension, as defined in RFC 8285.
+				Valid values are 1 to 14 for one-byte header extensions.
+				</xs:documentation>
+			</xs:annotation>
+			</xs:element>
+			<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> <!-- first Vendor then ONVIF -->
+		</xs:sequence>
+		<xs:anyAttribute processContents="lax"/>
+	</xs:complexType>
+	<!--===============================-->
+	<xs:complexType name="MulticastReceiverConfiguration">
+		<xs:sequence>
+			<xs:element name="Address" type="tt:IPAddress">
+				<xs:annotation>
+					<xs:documentation>The multicast address (if this address is set to 0 no multicast streaming is enabled)</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="Port" type="xs:int">
+				<xs:annotation>
+					<xs:documentation>The RTP multicast destination port. A device may support RTCP. In this case the port value shall be even to allow the corresponding RTCP stream to be mapped to the next higher (odd) destination port number as defined in the RTSP specification.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="TTL" type="xs:int">
+				<xs:annotation>
+					<xs:documentation>In case of IPv6 the TTL value is assumed as the hop limit. Note that for IPV6 and administratively scoped IPv4 multicast the primary use for hop limit / TTL is to prevent packets from (endlessly) circulating and not limiting scope. In these cases the address contains the scope.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="InterfaceToken" type="tt:ReferenceToken" minOccurs="0" maxOccurs="unbounded">
+					<xs:annotation>
+						<xs:documentation>Unique identifier of the network interface on the device. If not specified, all available interfaces will be used for listening. </xs:documentation>
+					</xs:annotation>
+			</xs:element>
+			<xs:element name="SourceSpecificMulticast" type="tt:IPAddress" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>When a source-specific multicast address is configured, the device will process multicast data only from the specified source, in accordance with SSM principles defined in RFC 4607.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>   <!-- first Vendor then ONVIF -->
+		</xs:sequence>
+		<xs:anyAttribute processContents="lax"/>
+	</xs:complexType>
+	<!--===============================-->
+	<xs:complexType name="MulticastAudioDecoderConfigurationOptions">
+		<xs:sequence>
+			<xs:element name="EncodingOptions" type="tt:AudioDecoder2Options">
+				<xs:annotation>
+					<xs:documentation>Supported encoding options for the multicast audio decoder.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="PriorityRange" type="tt:IntRange">
+				<xs:annotation>
+					<xs:documentation>
+						Specifies the priority range as an integer. This indicates the priority level for audio configuration.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="SecureStreamingProtocolAlgorithms" type="tt:StringList" minOccurs="0">
+						<xs:annotation>
+							<xs:documentation>
+							An optional parameter specifies the list of supported cryptographic algorithms when SRTP support is signaled as 'true' in the GetServiceCapabilitiesResponse.
+							Refer to tt:SrtpSecurityAlgorithms for the acceptable values.
+							</xs:documentation>
+						</xs:annotation>
+			</xs:element>
+			<xs:element name="AudioOutputTokens" type="tt:StringList" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>
+						Optional list of physical Audio output tokens. This element is used when only certain audio outputs can be configured for this token.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>   <!-- first ONVIF then Vendor -->
+		</xs:sequence>
+		<xs:anyAttribute processContents="lax"/>
+	</xs:complexType>
+	<!--===============================-->
+	<xs:complexType name="AudioDecoder2Options">
+		<xs:sequence>
+			<xs:element name="Encoding" type="xs:string">
+				<xs:annotation>
+					<xs:documentation>Audio Media Subtype for the audio format. For definitions see tt:AudioEncodingMimeNames and <a href="https://www.iana.org/assignments/media-types/media-types.xhtml#audio"> IANA Media Types</a>.</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="BitrateList" type="tt:IntItems">
+				<xs:annotation>
+					<xs:documentation>List of supported bitrates in kbps for the specified Encoding</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="SampleRateList" type="tt:IntItems">
+				<xs:annotation>
+					<xs:documentation>List of supported Sample Rates in kHz for the specified Encoding</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:element name="RTPPayloadType" type="xs:int" minOccurs="0">
+				<xs:annotation>
+					<xs:documentation>
+						Optional element for specifying the RTP payload type, 
+						particularly when it is fixed for a specific audio encoding as defined in <a href="https://www.iana.org/assignments/rtp-parameters/rtp-parameters.xhtml#rtp-parameters-1">IANA RTP Payload Types</a>.
+					</xs:documentation>
+				</xs:annotation>
+			</xs:element>
+			<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>   <!-- first ONVIF then Vendor -->
+		</xs:sequence>
+		<xs:anyAttribute processContents="lax"/>
+	</xs:complexType>
+	<!--===============================-->
 	<!--          Streaming            -->
 	<!--===============================-->
 	<xs:complexType name="MulticastConfiguration">

onvif/wsdl/ver20/media/wsdl/media.wsdl

@@ -53,6 +53,11 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 							<xs:documentation>Audio clip capabilities.</xs:documentation>
 						</xs:annotation>
 					</xs:element>
+					<xs:element name="MulticastAudioDecoderCapabilities" type="tr2:MulticastAudioDecoderCapabilities" minOccurs="0" > 
+						<xs:annotation>
+							<xs:documentation>MulticastAudioDecoder capabilities.</xs:documentation>
+						</xs:annotation>
+					</xs:element>
 					<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>   <!-- first ONVIF then Vendor -->
 				</xs:sequence>
 				<xs:attribute name="SnapshotUri" type="xs:boolean">
@@ -159,6 +164,29 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 				</xs:attribute>
 				<xs:anyAttribute processContents="lax"/>
 			</xs:complexType>
+
+			<!--===============================-->
+			<xs:complexType name="MulticastAudioDecoderCapabilities">
+				<xs:sequence>
+					<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>   <!-- first ONVIF then Vendor -->
+				</xs:sequence>
+				<xs:attribute name="MulticastAudioDecoder" type="xs:boolean">
+        		<xs:annotation>
+            		<xs:documentation>Indicates support for multicast audio decoder.</xs:documentation>
+        		</xs:annotation>
+    			</xs:attribute>
+				<xs:attribute name="SRTP" type="xs:boolean">
+        		<xs:annotation>
+            		<xs:documentation>Indicates whether the SRTP is supported in MulticastAudioDecoder or not.</xs:documentation>
+        		</xs:annotation>
+    			</xs:attribute>
+					<xs:attribute name="IPv6" type="xs:boolean">
+        		<xs:annotation>
+            		<xs:documentation>Indicates whether the IPv6 is supported in MulticastAudioDecoder or not.</xs:documentation>
+        		</xs:annotation>
+    			</xs:attribute>
+				<xs:anyAttribute processContents="lax"/>
+			</xs:complexType>
 			<!--===============================-->
 			<xs:complexType name="MediaSigningCapabilities">
 				<xs:sequence>
@@ -1621,6 +1649,62 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 				</xs:complexType>
 			</xs:element>
 			<!--===============================-->
+			
+			<xs:element name="GetMulticastAudioDecoderConfigurations">
+				<xs:complexType>
+					<xs:sequence>
+						<xs:element name="ConfigurationToken" type="tt:ReferenceToken"  minOccurs="0">
+							<xs:annotation>
+								<xs:documentation>Unique token of the multicast audio decoder configuration. If not passed, device shall respond with all configurations.</xs:documentation>
+							</xs:annotation>
+						</xs:element>
+					</xs:sequence>
+				</xs:complexType>
+			</xs:element>	
+			<xs:element name="GetMulticastAudioDecoderConfigurationsResponse">
+				<xs:complexType>
+					<xs:sequence>
+						<xs:element name="Configurations" type="tt:MulticastAudioDecoderConfiguration" minOccurs="0" maxOccurs="unbounded" >
+							<xs:annotation>
+								<xs:documentation>This message contains the list of multicast audio decoder configurations.</xs:documentation>
+							</xs:annotation>
+						</xs:element>
+					</xs:sequence>
+				</xs:complexType>
+			</xs:element>
+			
+			<xs:element name="GetMulticastAudioDecoderConfigurationOptions">
+				<xs:complexType>
+					<xs:sequence>
+						<xs:element name="ConfigurationToken" type="tt:ReferenceToken"  minOccurs="0">
+							<xs:annotation>
+								<xs:documentation>This response contains the available MulticastAudioDecoderConfigurationOptions. If a multicast audio decoder configuration is specified, the options shall concern that particular configuration.</xs:documentation>
+							</xs:annotation>
+						</xs:element>
+					</xs:sequence>
+				</xs:complexType>
+			</xs:element>
+			<xs:element name="GetMulticastAudioDecoderConfigurationOptionsResponse">
+				<xs:complexType>
+					<xs:sequence>
+						<xs:element name="Options" type="tt:MulticastAudioDecoderConfigurationOptions" maxOccurs="unbounded"/>
+					</xs:sequence>
+				</xs:complexType>
+			</xs:element>
+
+			<xs:element name="SetMulticastAudioDecoderConfiguration">
+				<xs:complexType>
+					<xs:sequence>
+						<xs:element name="Configuration" type="tt:MulticastAudioDecoderConfiguration">
+							<xs:annotation>
+								<xs:documentation>Contains the modified multicast audio decoder configuration. The configuration shall exist in the device.</xs:documentation>
+							</xs:annotation>
+						</xs:element>
+					</xs:sequence>
+				</xs:complexType>
+			</xs:element>
+			<xs:element name="SetMulticastAudioDecoderConfigurationResponse" type="tr2:SetConfigurationResponse"/>
+
 			<!--============ Schema End================-->
 		</xs:schema>
 	</wsdl:types>
@@ -1958,6 +2042,24 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
 	<wsdl:message name="GetPlayingAudioClipsResponse">
 		<wsdl:part name="parameters" element="tr2:GetPlayingAudioClipsResponse"/>
 	</wsdl:message>
+	<wsdl:message name="GetMulticastAudioDecoderConfigurationsRequest">
+		<wsdl:part name="parameters" element="tr2:GetMulticastAudioDecoderConfigurations"/>
+	</wsdl:message>
+	<wsdl:message name="GetMulticastAudioDecoderConfigurationsResponse">
+		<wsdl:part name="parameters" element="tr2:GetMulticastAudioDecoderConfigurationsResponse"/>
+	</wsdl:message>
+	<wsdl:message name="GetMulticastAudioDecoderConfigurationOptionsRequest">
+		<wsdl:part name="parameters" element="tr2:GetMulticastAudioDecoderConfigurationOptions"/>
+	</wsdl:message>
+	<wsdl:message name="GetMulticastAudioDecoderConfigurationOptionsResponse">
+		<wsdl:part name="parameters" element="tr2:GetMulticastAudioDecoderConfigurationOptionsResponse"/>
+	</wsdl:message>
+	<wsdl:message name="SetMulticastAudioDecoderConfigurationRequest">
+		<wsdl:part name="parameters" element="tr2:SetMulticastAudioDecoderConfiguration"/>
+	</wsdl:message>
+	<wsdl:message name="SetMulticastAudioDecoderConfigurationResponse">
+		<wsdl:part name="parameters" element="tr2:SetMulticastAudioDecoderConfigurationResponse"/>
+	</wsdl:message>
 	<wsdl:portType name="Media2">
 		<!--===============================-->
 		<!--===============================-->
@@ -2331,6 +2433,23 @@ image will be updated automatically and independent from calls to GetSnapshotUri
 			<wsdl:output message="tr2:GetPlayingAudioClipsResponse"/>
 		</wsdl:operation>
 		<!--==============AudioClipManagement Operation End=================-->
+			<!--==============MulticastAudioDecoder Operation=================-->
+		<wsdl:operation name="GetMulticastAudioDecoderConfigurations">
+			<wsdl:documentation>This operation gets the list of multicast audio decoder configurations.</wsdl:documentation>
+			<wsdl:input message="tr2:GetMulticastAudioDecoderConfigurationsRequest"/>
+			<wsdl:output message="tr2:GetMulticastAudioDecoderConfigurationsResponse"/>
+		</wsdl:operation>
+		<wsdl:operation name="GetMulticastAudioDecoderConfigurationOptions">
+			<wsdl:documentation>This operation gets the available options for the MulticastAudioDecoder configuration.</wsdl:documentation>
+			<wsdl:input message="tr2:GetMulticastAudioDecoderConfigurationOptionsRequest"/>
+			<wsdl:output message="tr2:GetMulticastAudioDecoderConfigurationOptionsResponse"/>
+		</wsdl:operation>
+		<wsdl:operation name="SetMulticastAudioDecoderConfiguration">
+			<wsdl:documentation>This operation sets the MulticastAudioDecoderConfiguration.</wsdl:documentation>
+			<wsdl:input message="tr2:SetMulticastAudioDecoderConfigurationRequest"/>
+			<wsdl:output message="tr2:SetMulticastAudioDecoderConfigurationResponse"/>
+		</wsdl:operation>
+		<!--===========MulticastAudioDecoder Operation End ===============-->
 	</wsdl:portType>
 	<wsdl:binding name="Media2Binding" type="tr2:Media2">
 		<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
@@ -2858,5 +2977,34 @@ image will be updated automatically and independent from calls to GetSnapshotUri
 			</wsdl:output>
 		</wsdl:operation>
 		<!--==============AudioClipManagement End=================-->
+		<!--==============Multicast Audio Decoder Configuration =================-->
+		<wsdl:operation name="GetMulticastAudioDecoderConfigurations">
+			<soap:operation soapAction="http://www.onvif.org/ver20/media/wsdl/GetMulticastAudioDecoderConfigurations"/>
+			<wsdl:input>
+				<soap:body use="literal"/>
+			</wsdl:input>
+			<wsdl:output>
+				<soap:body use="literal"/>
+			</wsdl:output>
+		</wsdl:operation>
+		<wsdl:operation name="GetMulticastAudioDecoderConfigurationOptions">
+			<soap:operation soapAction="http://www.onvif.org/ver20/media/wsdl/GetMulticastAudioDecoderConfigurationOptions"/>
+			<wsdl:input>
+				<soap:body use="literal"/>
+			</wsdl:input>
+			<wsdl:output>
+				<soap:body use="literal"/>
+			</wsdl:output>
+		</wsdl:operation>
+		<wsdl:operation name="SetMulticastAudioDecoderConfiguration">
+			<soap:operation soapAction="http://www.onvif.org/ver20/media/wsdl/SetMulticastAudioDecoderConfiguration"/>
+			<wsdl:input>
+				<soap:body use="literal"/>
+			</wsdl:input>
+			<wsdl:output>
+				<soap:body use="literal"/>
+			</wsdl:output>
+		</wsdl:operation>
+		<!--==============Multicast Audio Decoder Configuration End =================-->
 	</wsdl:binding>
 </wsdl:definitions>

{onvif_python-0.2.4.dist-info → onvif_python-0.2.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: onvif-python
-Version: 0.2.4
+Version: 0.2.6
 Summary: A modern Python library for ONVIF-compliant devices
 Author-email: Nirsimetri Technologies® <open@nirsimetri.com>
 Maintainer: Kaburagi
@@ -44,13 +44,13 @@ Dynamic: license-file
 <h1 align="center">ONVIF Python</h1>
 
 <div align="center">
-<img alt="Codacy grade" src="https://img.shields.io/codacy/grade/bff08a94e4d447b690cea49c6594826d?label=Code%20Quality&logo=codacy" href="https://app.codacy.com/gh/nirsimetri/onvif-python/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade">
-<img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" href="https://deepwiki.com/nirsimetri/onvif-python">
-<img alt="PyPI Version" src="https://img.shields.io/badge/PyPI-0.2.4-orange?logo=archive&color=yellow" href="https://pypi.org/project/onvif-python/">
-<img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/onvif-python?label=Downloads&color=red" href="https://pepy.tech/projects/onvif-python">
+<a href="https://app.codacy.com/gh/nirsimetri/onvif-python/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img src="https://app.codacy.com/project/badge/Grade/bff08a94e4d447b690cea49c6594826d"/></a>
+<a href="https://deepwiki.com/nirsimetri/onvif-python"><img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg"></a>
+<a href="https://pypi.org/project/onvif-python/"><img alt="PyPI Version" src="https://img.shields.io/badge/PyPI-0.2.6-orange?logo=archive&color=yellow"></a>
+<a href="https://pepy.tech/projects/onvif-python"><img alt="Pepy Total Downloads" src="https://img.shields.io/pepy/dt/onvif-python?label=Downloads&color=red"></a>
 <br>
-<img alt="Build" src="https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml/badge.svg?branch=main" href="https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml">
-<img alt="Upload Python Package" src="https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml/badge.svg" href="https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml">
+<a href="https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml"><img alt="Build" src="https://github.com/nirsimetri/onvif-python/actions/workflows/python-app.yml/badge.svg?branch=main"></a>
+<a href="https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml"><img alt="Upload Python Package" src="https://github.com/nirsimetri/onvif-python/actions/workflows/python-publish.yml/badge.svg"></a>
 </div>
 
 <h1 align="center">
@@ -64,15 +64,21 @@ Dynamic: license-file
 
 Behind the scenes, ONVIF communication relies on **[SOAP](https://en.wikipedia.org/wiki/SOAP) (Simple Object Access Protocol)** — an [XML](https://en.wikipedia.org/wiki/XML)-based messaging protocol with strict schema definitions ([WSDL](https://en.wikipedia.org/wiki/Web_Services_Description_Language)/[XSD](https://en.wikipedia.org/wiki/XML_Schema_(W3C))). SOAP ensures interoperability, but when used directly it can be verbose, complex, and error-prone.  
 
-This library simplifies that process by wrapping SOAP communication into a clean, Pythonic API. You no longer need to handle low-level XML parsing, namespaces, or security tokens manually — the library takes care of it, letting you focus on building functionality.  
+This library simplifies that process by wrapping SOAP communication into a clean, Pythonic API. You no longer need to handle low-level XML parsing, namespaces, or security tokens manually — the library takes care of it, letting you focus on building functionality.
 
-## Key Features
-- Full implementation of ONVIF core services and profiles  
-- Support for device discovery, media streaming, PTZ control, event management, and more  
-- Pythonic abstraction over SOAP requests and responses (no need to handcraft XML)  
-- Extensible architecture for custom ONVIF extensions  
-- Compatible with multiple ONVIF specification versions  
-- Example scripts and tests included  
+## Library Philosophy
+> [!NOTE]
+> This library will be continuously updated as ONVIF versions are updated. It uses a built-in WSDL that will always follow changes to the [ONVIF WSDL Specifications](https://github.com/onvif/specs). You can also use your own ONVIF WSDL file by adding the `wsdl_dir` argument; see [ONVIFClient Parameters](#onvifclient-parameters).
+
+- **WYSIWYG (What You See is What You Get)**: Every ONVIF operation in the library mirrors the official ONVIF specification exactly. Method names, parameter structures, and response formats follow ONVIF standards without abstraction layers or renamed interfaces. What you see in the ONVIF documentation is exactly what you get in Python.
+
+- **Device Variety Interoperability**: Built to handle the real-world diversity of ONVIF implementations across manufacturers. The library gracefully handles missing features, optional operations, and vendor-specific behaviors through comprehensive error handling and fallback mechanisms. Whether you're working with high-end enterprise cameras or budget IP cameras, the library adapts.
+
+- **Official Specifications Accuracy**: All service implementations are generated and validated against official `ONVIF WSDL Specifications`. The library includes comprehensive test suites that verify compliance with ONVIF standards, ensuring that method signatures, parameter types, and behavior match the official specifications precisely.
+
+- **Modern Python Approach**: Designed for excellent IDE support with full type hints, auto-completion, and immediate error detection. You'll get `TypeError` exceptions upfront when accessing ONVIF operations with wrong arguments, instead of cryptic `SOAP faults` later. Clean, Pythonic API that feels natural to Python developers while maintaining ONVIF compatibility.
+
+- **Minimal Dependencies**: Only depends on essential, well-maintained libraries (`zeep` for SOAP, `requests` for HTTP). No bloated framework dependencies or custom XML parsers. The library stays lightweight while providing full ONVIF functionality, making it easy to integrate into any project without dependency conflicts.
 
 ## Who Is It For?
 - **Individual developers** exploring ONVIF or building hobby projects  
@@ -351,11 +357,12 @@ This library includes a powerful command-line interface (CLI) for interacting wi
 <summary><b>1. Direct CLI</b></summary> 
 
 ```bash
-usage: onvif [-h] [--host HOST] [--port PORT] [--username USERNAME] [--password PASSWORD] [--discover] [--filter FILTER] [--search SEARCH] [--page PAGE] [--per-page PER_PAGE] [--timeout TIMEOUT] [--https]
-             [--no-verify] [--no-patch] [--interactive] [--debug] [--wsdl WSDL] [--cache {all,db,mem,none}] [--health-check-interval HEALTH_CHECK_INTERVAL] [--version]
+usage: onvif [-h] [--host HOST] [--port PORT] [--username USERNAME] [--password PASSWORD] [--discover] [--filter FILTER] [--search SEARCH] [--page PAGE]
+             [--per-page PER_PAGE] [--timeout TIMEOUT] [--https] [--no-verify] [--no-patch] [--interactive] [--debug] [--wsdl WSDL]
+             [--cache {all,db,mem,none}] [--health-check-interval HEALTH_CHECK_INTERVAL] [--output OUTPUT] [--version]
              [service] [method] [params ...]
 
-ONVIF Terminal Client — v0.2.4
+ONVIF Terminal Client — v0.2.6
 https://github.com/nirsimetri/onvif-python
 
 positional arguments:
@@ -389,6 +396,9 @@ options:
                         Caching mode for ONVIFClient (default: all). 'all': memory+disk, 'db': disk-only, 'mem': memory-only, 'none': disabled.
   --health-check-interval HEALTH_CHECK_INTERVAL, -hci HEALTH_CHECK_INTERVAL
                         Health check interval in seconds for interactive mode (default: 10)
+  --output OUTPUT, -o OUTPUT
+                        Save command output to file. Supports .json, .xml extensions for format detection, or plain text. XML format automatically enables
+                        debug mode for SOAP capture.
   --version, -v         Show ONVIF CLI version and exit
 
 Examples:
@@ -409,7 +419,12 @@ Examples:
 
   # Direct command execution
   onvif devicemgmt GetCapabilities Category=All --host 192.168.1.17 --port 8000 --username admin --password admin123
-  onvif ptz ContinuousMove ProfileToken=Profile_1 Velocity={"PanTilt": {"x": -0.1, "y": 0}} --host 192.168.1.17 --port 8000 --username admin --password admin123
+  onvif ptz ContinuousMove ProfileToken=Profile_1 Velocity={'PanTilt': {'x': -0.1, 'y': 0}} -H 192.168.1.17 -P 8000 -u admin -p admin123
+
+  # Save output to file
+  onvif devicemgmt GetDeviceInformation --host 192.168.1.17 --port 8000 --username admin --password admin123 --output device_info.json
+  onvif media GetProfiles --host 192.168.1.17 --port 8000 --username admin --password admin123 --output profiles.xml
+  onvif ptz GetConfigurations --host 192.168.1.17 --port 8000 --username admin --password admin123 --output ptz_config.txt --debug
 
   # Interactive mode
   onvif --host 192.168.1.17 --port 8000 --username admin --password admin123 --interactive
@@ -428,7 +443,7 @@ Examples:
 <summary><b>2. Interactive Shell</b></summary> 
 
 ```bash
-ONVIF Interactive Shell — v0.2.4
+ONVIF Interactive Shell — v0.2.6
 https://github.com/nirsimetri/onvif-python
 
 Basic Commands:
@@ -636,7 +651,11 @@ onvif <service> <method> [parameters...] -H <host> -P <port> -u <user> -p <pass>
 onvif devicemgmt GetCapabilities Category=All -H 192.168.1.17 -P 8000 -u admin -p admin123
 
 # Move a PTZ camera
-onvif ptz ContinuousMove ProfileToken=Profile_1 Velocity='{"PanTilt": {"x": 0.1}}' -H 192.168.1.17 -P 8000 -u admin -p admin123
+onvif ptz ContinuousMove ProfileToken=Profile_1 Velocity='{"PanTilt": {"x": 0.1, "y": 0}}' -H 192.168.1.17 -P 8000 -u admin -p admin123
+
+# Save output to file
+onvif devicemgmt GetDeviceInformation --host 192.168.1.17 --port 8000 --username admin --password admin123 --output device_info.json
+onvif media GetProfiles -H 192.168.1.17 -P 8000 -u admin -p admin123 -o profiles.xml
 ```
 
 **4. ONVIF Product Search**
@@ -1152,13 +1171,11 @@ Some ONVIF services have multiple bindings in the same WSDL. These typically inc
 - [ ] Add more usage examples for advanced features.
 - [ ] Add benchmarking and performance metrics.
 - [ ] Add community-contributed device configuration templates.
-- [ ] Implement missing or partial ONVIF services.
-- [ ] Add function to expose ONVIF devices (for debugging purposes by the community).
 
 ## Related Projects
 
 - [onvif-products-directory](https://github.com/nirsimetri/onvif-products-directory):
-	This project is a comprehensive ONVIF data aggregation and management suite, designed to help developers explore, analyze, and process ONVIF-compliant product information from hundreds of manufacturers worldwide. It provides a unified structure for device, client, and company data, making it easier to perform research, build integrations, and generate statistics for ONVIF ecosystem analysis.
+	This project is a comprehensive ONVIF data aggregation and management suite, designed to help developers explore, analyze, and process ONVIF-compliant product information from hundreds of manufacturers worldwide.
 
 - (soon) [onvif-rest-server](https://github.com/nirsimetri/onvif-rest-server):
 	A RESTful API server for ONVIF devices, enabling easy integration of ONVIF device management, media streaming, and other capabilities into web applications and services.

{onvif_python-0.2.4.dist-info → onvif_python-0.2.6.dist-info}/RECORD

@@ -1,10 +1,10 @@
-onvif/__init__.py,sha256=JYjHyKme5ou0I63dBnArAwN1rAIFalHXv_AgIgLgT-Y,499
+onvif/__init__.py,sha256=0wZNZnISPA9kZQ0J2UIDHCTvfHKDPgupHM32WTJeKLw,463
 onvif/client.py,sha256=_G00dKSvRkLKq5tDGm4XS_3fhSE3WJtYckK9WVzNj9c,27703
 onvif/operator.py,sha256=fBaoWYC3ZVFdgd2S_cmztWiLAA-HaWwSflq278YNlTs,13970
 onvif/cli/__init__.py,sha256=y3hc-mo-Iwwxf8m5vo9P_0m2ISzGuOy-jaRPkdRY05A,68
 onvif/cli/__main__.py,sha256=IZyZcevWVKE1BzdFY53a3MjOOfybncGVVXQ_7lZ3TOQ,165
-onvif/cli/interactive.py,sha256=wCRoqf0zqitxMiy7Qgrf_7fg7PD5tFk71zLnvMsvcxA,59756
-onvif/cli/main.py,sha256=atXPXrRif_FMg4RFf4GYeYx-POX4xYs4hFLGZU9l50s,27312
+onvif/cli/interactive.py,sha256=8_B-IQ-0Sf7c08gTxqMH1JAhcdCp2mOAq1Sdh7xP4iU,59756
+onvif/cli/main.py,sha256=sxJz2IgACnqxh0l3fJDQ0W65Cu2Ju1EDusip87-CHW4,35751
 onvif/cli/utils.py,sha256=o3lGeJ3yCgaINgXiq7wF0wB9KlR1qpvhNrW92onP4B4,60477
 onvif/db/companies.db,sha256=yJ8bSHfGpxNnA5NRBhYOFS_1Pix-KgH8GnUFV3ytzPo,270336
 onvif/db/products.db,sha256=4BVPfy6i6pLMLQyfue238uRp6_NIDodu4QXd9iCoooY,81559552
@@ -17,12 +17,12 @@ onvif/services/appmgmt.py,sha256=x4T5H0jJCScCuVCN8fyVdZyg1cnBKpRnVdo9eaPY2sg,155
 onvif/services/authenticationbehavior.py,sha256=sxyy23VuVbyp6eIMQAqirVRzjszaZ6S8J7yHoD6IT6U,3560
 onvif/services/credential.py,sha256=0FdumDUdF5ztlNYXRTLb4b8B1-82F2Hk98spm37igV8,5734
 onvif/services/deviceio.py,sha256=BZd3mlGhApFuj8jSpsjCvKdN0V2dknYs7kVL6p5QR-A,6028
-onvif/services/devicemgmt.py,sha256=5XGRcsYjGfA36F6NgrT1CSw6TZPaVbkgLeQprtcG0rw,14358
+onvif/services/devicemgmt.py,sha256=71mrQ7V8I4Ysemg9cOGZdqALgLNS5rab7LYR1r5NRi0,14469
 onvif/services/display.py,sha256=1XNTj1Gjq_9H7QWJqsilZNVaW4EIPdEAMmM4cXzh4bQ,2424
 onvif/services/doorcontrol.py,sha256=krx5R_iS-YKTvTDilp-3IQExPo3y5WdcVe9k0AXLsLo,3171
 onvif/services/imaging.py,sha256=LZcpDpDvVGQjYz14pcIfju2RIq23l3Fl-1C9OOYvubI,2519
 onvif/services/media.py,sha256=uhY2jLvbh1ewYMAGRNv_jXS7Y-k7wHsEgHIKo1D0x2k,15513
-onvif/services/media2.py,sha256=byFdwDkfoV2wKgTaT3ujKiac8h_qWO-5kRiATkKwK4U,11070
+onvif/services/media2.py,sha256=zHVWhyRMa2b56Ii4VLCQYtE5I-3FSmsZyC3d61rF_u0,11737
 onvif/services/provisioning.py,sha256=SAK-TWBjhvQsadgN1ykt41UXU7fIXF2refcWOjVAjY4,2087
 onvif/services/ptz.py,sha256=6TxdD-g0EKSczLoLK-y0GO5XZ4-ax03Q8lFolS9RH9w,6342
 onvif/services/receiver.py,sha256=xyVmnPpGKHxenTcAGYkGm7bApP7hkVAc6JW-32mUQv8,1820
@@ -68,7 +68,7 @@ onvif/wsdl/ver10/search.wsdl,sha256=XryLMEVa4MwbDBbMDYcDkJ5HpSQe8HZAOo5XZ-FE1Qw,
 onvif/wsdl/ver10/accesscontrol/wsdl/index.html,sha256=Z_UrJjF4N239VPl7waRb1eTGyk5i5-aFLbbKNjSYwd8,126
 onvif/wsdl/ver10/accessrules/wsdl/accessrules.wsdl,sha256=0S5zNwrYrVrzEDVwPjE6l1Uwt9ps1nOl2cOypocHpng,30010
 onvif/wsdl/ver10/accessrules/wsdl/index.html,sha256=5lqKqf1y9W0B5zNuWsN1y8x_V2nAV8l5ytdDNfs56Do,113
-onvif/wsdl/ver10/advancedsecurity/wsdl/advancedsecurity.wsdl,sha256=I82XYAuhMRNwGpAeOl7gdTbQ5MoNqcSB7ndD7Wuix8I,197690
+onvif/wsdl/ver10/advancedsecurity/wsdl/advancedsecurity.wsdl,sha256=HuFCKCSAhflRTlWoZRlSpK2_GpQ8GwysFIAkxZfVfEc,197887
 onvif/wsdl/ver10/advancedsecurity/wsdl/index.html,sha256=MA1CUtes6XUvYfsVGpmslKSENeSiEgqUHMwOsLt9fck,118
 onvif/wsdl/ver10/appmgmt/wsdl/appmgmt.wsdl,sha256=hFkm8zMgLBy3XpXNQM1R8wPecFoKSmW3sFncFlPyDHM,24676
 onvif/wsdl/ver10/appmgmt/wsdl/index.html,sha256=TiH4sPOslNi2H-5XSmMWcNItjsevyhuTrQO-I_CC4WM,109
@@ -76,7 +76,7 @@ onvif/wsdl/ver10/authenticationbehavior/wsdl/authenticationbehavior.wsdl,sha256=
 onvif/wsdl/ver10/authenticationbehavior/wsdl/index.html,sha256=bJLmkfHuSuQHjIm3UIkMaJJ0tkT5ZsM8QBwhB6u57H0,124
 onvif/wsdl/ver10/credential/wsdl/credential.wsdl,sha256=WGAjT4x6iNykOJyCqrAFzavmxBcCbSZsp0BnyP24tg8,85719
 onvif/wsdl/ver10/credential/wsdl/index.html,sha256=idxTLpugvoWrJDS9B2tN27g66ZsdPoWaXYynlpql0EQ,112
-onvif/wsdl/ver10/device/wsdl/devicemgmt.wsdl,sha256=i67llntHj9tKJrGt29FHGdVl4o-GsCaWtcNboRCVW9o,188428
+onvif/wsdl/ver10/device/wsdl/devicemgmt.wsdl,sha256=uOoJ9lKSW4z8NZ2zf4FOKr2w5NhkMKt3gmQDgg72bPc,190861
 onvif/wsdl/ver10/display/display.wsdl,sha256=Ac4MKiBhskPVIh3HvaPA0wUcaZojyDuye62h9TdG0_M,20747
 onvif/wsdl/ver10/display/wsdl/index.htm,sha256=Ac4MKiBhskPVIh3HvaPA0wUcaZojyDuye62h9TdG0_M,20747
 onvif/wsdl/ver10/doorcontrol/wsdl/index.html,sha256=OBz9e4EiEJDDBri1bgppnxhREN1-Um7Q9QhdSGLdiJI,124
@@ -92,8 +92,8 @@ onvif/wsdl/ver10/provisioning/wsdl/provisioning.wsdl,sha256=l5gElFQQp7nLPDZ9Zkjj
 onvif/wsdl/ver10/schedule/wsdl/index.html,sha256=PoHypOFmhjvH8OkZUzWwl_IEBMCrVtXm-y_dKJ0cKog,110
 onvif/wsdl/ver10/schedule/wsdl/schedule.wsdl,sha256=nAkZMKIImsUp6uK5_Vc53VC4sTrUsaU88BNNdQTaXR8,56036
 onvif/wsdl/ver10/schema/common.xsd,sha256=4uMtegaEf6PGeG29C_Ifm3a3ef-scDJbXsh7ry0Nb9k,18659
-onvif/wsdl/ver10/schema/metadatastream.xsd,sha256=DyHIDS_MLZpr4MRCiJ7e7MrLVpfx8zQGi8f-N9dhV_E,25772
-onvif/wsdl/ver10/schema/onvif.xsd,sha256=lCzajbbHhM350D3Hw4RLvf71Zj8tpecjVOZZgOmrBsU,397467
+onvif/wsdl/ver10/schema/metadatastream.xsd,sha256=jFVg0SNDHUBa48fLG0DpwcOo2SGf9Xf6u0JCfp_icuQ,25841
+onvif/wsdl/ver10/schema/onvif.xsd,sha256=8MJRH1IdsfKtXs5G0qe-eVDzLlzeYxbgR1q3_EeIA6w,408061
 onvif/wsdl/ver10/thermal/wsdl/index.html,sha256=_IdT_ariTD2VNurydgZw88LwB6pxLalZ6eU6yg0bYKU,109
 onvif/wsdl/ver10/thermal/wsdl/thermal.wsdl,sha256=gGv4JTEYwtXW7RS2JEq2t73o26j-dvdfrRis_RlQBGE,33353
 onvif/wsdl/ver10/topics/topicns.xml,sha256=W8fnvV5MgGUehItXxNbMAQnkzQfUdLMe79uF9FqEq9U,2008
@@ -108,15 +108,15 @@ onvif/wsdl/ver20/analytics/wsdl/analytics.wsdl,sha256=zAkRc3HJR5Gy0brmEJcPdqdkv3
 onvif/wsdl/ver20/analytics/wsdl/index.html,sha256=1ylR91EUE7Rls3WsEZiJSVl7vQcu0N5rsrcHvS6B32E,111
 onvif/wsdl/ver20/imaging/wsdl/imaging.wsdl,sha256=gbNeJbtLYzA0RAoNY0kr2T8G4rnPDsQA9LFFwRvZRKg,26153
 onvif/wsdl/ver20/media/wsdl/index.html,sha256=Brecp_D7gpnotiLYNZeEb9mSHr9IXDFFNY2XY8Djefg,107
-onvif/wsdl/ver20/media/wsdl/media.wsdl,sha256=ZkQPSYRqfRYqR5NVnVaIy_Efcz85XSmC1s9GGW9Es_U,135176
+onvif/wsdl/ver20/media/wsdl/media.wsdl,sha256=DQItUaVekLRkrceB1jTsVo-Omqaz4QIYSbs0LaemKbM,142353
 onvif/wsdl/ver20/ptz/wsdl/ptz.wsdl,sha256=jkS0UPSv0znv2zcCV0QC73OPt3KHpoDKIcBSnd4snqQ,60601
 onvif/wsdl/ver20/util/federated_search_documentation.html,sha256=GR6a4SPBsRDisaWRoajGLMJOd6LCjyyeghMyy7ebcyQ,86523
 onvif/wsdl/ver20/util/fedsearch-docu-viewer.xsl,sha256=8eP-uMZgsTtuU5WaVyCzs_DJZqWIFD7iRz_5-3ComPg,325
 onvif/wsdl/ver20/util/onvif-wsdl-viewer.xsl,sha256=Emauxs6rh69IxlxlU3k_LEH_i3SsRbwIKUk-VcMlVgk,94525
 onvif/wsdl/ver20/util/operationIndex.html,sha256=mUsAGgNUFCIQjVV9Rx_O5YUNW3EdWNhUkAbBY-xVMhQ,39290
-onvif_python-0.2.4.dist-info/licenses/LICENSE.md,sha256=ya8FumJeUkFWwCMkG9KdMxHWRWMNhtI3vHzzAWPQS8s,1091
-onvif_python-0.2.4.dist-info/METADATA,sha256=BL1P0TDO26TwYU0a0qyzYSs2a19lGy61GVZo4jKYwvQ,59944
-onvif_python-0.2.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-onvif_python-0.2.4.dist-info/entry_points.txt,sha256=7xUdI64yzWh7YfNPQDKCW9cT8XIgWuNCloikP9-yjqY,46
-onvif_python-0.2.4.dist-info/top_level.txt,sha256=MqCi1uJmIvtVFJDz2IxLbpwq6FwDtWhqrWQtKwLaQg4,6
-onvif_python-0.2.4.dist-info/RECORD,,
+onvif_python-0.2.6.dist-info/licenses/LICENSE.md,sha256=ya8FumJeUkFWwCMkG9KdMxHWRWMNhtI3vHzzAWPQS8s,1091
+onvif_python-0.2.6.dist-info/METADATA,sha256=xqtYGkn1MjrjEarbJaN8TH57rJDmfUNAnJuYpqfVfpg,62247
+onvif_python-0.2.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+onvif_python-0.2.6.dist-info/entry_points.txt,sha256=7xUdI64yzWh7YfNPQDKCW9cT8XIgWuNCloikP9-yjqY,46
+onvif_python-0.2.6.dist-info/top_level.txt,sha256=MqCi1uJmIvtVFJDz2IxLbpwq6FwDtWhqrWQtKwLaQg4,6
+onvif_python-0.2.6.dist-info/RECORD,,