{ "api_version": "1", "kind": "dse_post", "self": "https://update.dsesecurity.com/api/v1/posts/read-the-axis-audio-plugin-schema-before-changing-its-settings/", "item": { "id": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/", "slug": "read-the-axis-audio-plugin-schema-before-changing-its-settings", "url": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/", "alternate_urls": { "markdown": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings.md", "json": "https://update.dsesecurity.com/api/v1/posts/read-the-axis-audio-plugin-schema-before-changing-its-settings/" }, "title": "Read the Axis audio plugin schema before changing its settings", "summary": "Read the actual Axis audio plugin schema and current settings together before editing a plugin. Do not copy property names, units or limits from another plugin’s example.", "format": { "slug": "guide", "name": "Guide" }, "priority": { "slug": "advisory", "name": "Advisory" }, "featured": false, "image": { "theme": "physical-security", "label": "Physical security", "alt": "Integrated video surveillance and controlled entry at a modern commercial facility.", "card_url": "https://update.dsesecurity.com/assets/editorial/physical-security-card.webp?v=1.8.20", "hero_url": "https://update.dsesecurity.com/assets/editorial/physical-security-hero.webp?v=1.8.20", "social_url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20", "width": 2400, "height": 1350 }, "topics": [ { "slug": "it", "name": "IT", "url": "https://update.dsesecurity.com/topic/it/" }, { "slug": "video-surveillance", "name": "Video Surveillance", "url": "https://update.dsesecurity.com/topic/video-surveillance/" } ], "author": { "name": "DSE Security Editorial Team", "url": "https://update.dsesecurity.com/#editorial-team", "type": "Organization" }, "publisher": { "name": "Detection Systems & Engineering", "url": "https://dsesecurity.com/" }, "published_at": "2026-10-29T19:49:53+00:00", "modified_at": "2026-10-29T19:50:08+00:00", "reviewed_on": "2026-10-29", "reading_minutes": 3, "word_count": 524, "potentially_affected": "Axis products exposing the documented Audio Analytics interface; confirm actual device, hardware and software applicability before applying the proposed checks.", "dse_recommendation": "DSE recommends reviewing the current settings against the matching plugin schema before constructing an update.", "primary_source": { "name": "Axis Communications — Audio Analytics", "url": "https://developer.axis.com/vapix/audio-systems/audio-analytics/", "published_on": null, "authority": "Axis Communications" }, "publishing_principles": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/", "usage_info": "https://update.dsesecurity.com/usage/", "copyright_notice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.", "content_html": "

Bottom line: Use the installed plugin’s own schema as the setting contract. Keep the exact device, input or output and plugin identity together so a familiar threshold name does not substitute for the correct property definition.

\n

Source fact: documented behavior

\n

Axis’s Audio Analytics gives each audio plugin its own settings object and provides getPluginsSchemas to describe those settings.

\n

getPluginsSettings retrieves configured audio-plugin settings across audio sources; the source says their properties are plugin specific and defined by the returned JSON schema.

\n

The documentation separates Audio Analytics configuration from Audio Device Control, which configures the hardware devices.

\n

What the source does not establish

\n

Do not infer that two plugins share property names, units, valid ranges or detection performance. Treat sample settings as examples rather than a compatibility list. Keep microphone power and other hardware changes outside this plugin-setting procedure, and do not describe a valid settings object as proof of an accurate analytic result.

\n

Applicability questions

\n\n

DSE recommendation: controlled next steps

\n

The following steps are DSE recommendations based on the cited source.

\n

DSE recommends reviewing the current settings against the matching plugin schema before constructing an update.

\n
    \n
  1. Retrieve the supported schema and settings responses from the target device. Match the device, input or output and plugin identifiers before reviewing individual properties. Record the intended change and preserve the current settings. If the plugin or property cannot be matched to its schema, stop and resolve that identity issue rather than borrowing a nearby example.
    2. \n
  2. Have the integration owner review the selected property’s type, limits and description from the actual schema. Use a harmless proposed value within the documented requirements for a pilot. Keep unit interpretation explicit; avoid assuming that a number meaningful to another analytic or interface has the same meaning here. Construct the supported update without changing unrelated hardware settings.
    3. \n
  3. Apply the approved plugin change and retrieve its settings again. Compare the readback with the intended update before evaluating acoustic behavior. Use the owner’s authorized harmless input and an appropriate observation window for the separate functional check. If configuration or behavior is unresolved, retain the discrepancy and use the supported restoration process instead of experimenting across several plugins simultaneously.
    4. \n
\n

Verification and evidence

\n

Retain the schema revision or complete returned schema, exact plugin path, previous and requested settings, sanitized operation result and readback. Keep acoustic observations separately attributed to the actual test conditions. Have a reviewer explain the chosen unit and limit from the correct schema rather than from memory.

\n

Include a proposed desk case with a property copied from a different plugin and require the reviewer to identify the mismatch. Record actual outcomes only after the approved pilot. This article supplies no universal threshold, supported-plugin inventory or measured classification or detection accuracy.

\n

Official references

\n\n

Source review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.

\n", "content_text": "Bottom line: Use the installed plugin’s own schema as the setting contract. Keep the exact device, input or output and plugin identity together so a familiar threshold name does not substitute for the correct property definition.\nSource fact: documented behavior\nAxis’s Audio Analytics gives each audio plugin its own settings object and provides getPluginsSchemas to describe those settings.\ngetPluginsSettings retrieves configured audio-plugin settings across audio sources; the source says their properties are plugin specific and defined by the returned JSON schema.\nThe documentation separates Audio Analytics configuration from Audio Device Control, which configures the hardware devices.\nWhat the source does not establish\nDo not infer that two plugins share property names, units, valid ranges or detection performance. Treat sample settings as examples rather than a compatibility list. Keep microphone power and other hardware changes outside this plugin-setting procedure, and do not describe a valid settings object as proof of an accurate analytic result.\nApplicability questions\n\nWhich installed plugin and actual input or output are being changed?\nWhich schema describes that exact plugin’s settings?\nWhat current property, type, unit and permitted value are relevant?\nWhat approved acoustic observation will assess the intended result separately from configuration acceptance?\n\nDSE recommendation: controlled next steps\nThe following steps are DSE recommendations based on the cited source.\nDSE recommends reviewing the current settings against the matching plugin schema before constructing an update.\n\nRetrieve the supported schema and settings responses from the target device. Match the device, input or output and plugin identifiers before reviewing individual properties. Record the intended change and preserve the current settings. If the plugin or property cannot be matched to its schema, stop and resolve that identity issue rather than borrowing a nearby example.\nHave the integration owner review the selected property’s type, limits and description from the actual schema. Use a harmless proposed value within the documented requirements for a pilot. Keep unit interpretation explicit; avoid assuming that a number meaningful to another analytic or interface has the same meaning here. Construct the supported update without changing unrelated hardware settings.\nApply the approved plugin change and retrieve its settings again. Compare the readback with the intended update before evaluating acoustic behavior. Use the owner’s authorized harmless input and an appropriate observation window for the separate functional check. If configuration or behavior is unresolved, retain the discrepancy and use the supported restoration process instead of experimenting across several plugins simultaneously.\n\nVerification and evidence\nRetain the schema revision or complete returned schema, exact plugin path, previous and requested settings, sanitized operation result and readback. Keep acoustic observations separately attributed to the actual test conditions. Have a reviewer explain the chosen unit and limit from the correct schema rather than from memory.\nInclude a proposed desk case with a property copied from a different plugin and require the reviewer to identify the mismatch. Record actual outcomes only after the approved pilot. This article supplies no universal threshold, supported-plugin inventory or measured classification or detection accuracy.\nOfficial references\n\nAudio Analytics — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.", "content_markdown": "Bottom line: Use the installed plugin’s own schema as the setting contract. Keep the exact device, input or output and plugin identity together so a familiar threshold name does not substitute for the correct property definition.\n\n## Source fact: documented behavior\n\nAxis’s [Audio Analytics](https://developer.axis.com/vapix/audio-systems/audio-analytics/) gives each audio plugin its own settings object and provides getPluginsSchemas to describe those settings.\n\ngetPluginsSettings retrieves configured audio-plugin settings across audio sources; the source says their properties are plugin specific and defined by the returned JSON schema.\n\nThe documentation separates Audio Analytics configuration from Audio Device Control, which configures the hardware devices.\n\n## What the source does not establish\n\nDo not infer that two plugins share property names, units, valid ranges or detection performance. Treat sample settings as examples rather than a compatibility list. Keep microphone power and other hardware changes outside this plugin-setting procedure, and do not describe a valid settings object as proof of an accurate analytic result.\n\n## Applicability questions\n\n- Which installed plugin and actual input or output are being changed?\n\n- Which schema describes that exact plugin’s settings?\n\n- What current property, type, unit and permitted value are relevant?\n\n- What approved acoustic observation will assess the intended result separately from configuration acceptance?\n\n## DSE recommendation: controlled next steps\n\nThe following steps are DSE recommendations based on the cited source.\n\nDSE recommends reviewing the current settings against the matching plugin schema before constructing an update.\n\n- Retrieve the supported schema and settings responses from the target device. Match the device, input or output and plugin identifiers before reviewing individual properties. Record the intended change and preserve the current settings. If the plugin or property cannot be matched to its schema, stop and resolve that identity issue rather than borrowing a nearby example.\n\n- Have the integration owner review the selected property’s type, limits and description from the actual schema. Use a harmless proposed value within the documented requirements for a pilot. Keep unit interpretation explicit; avoid assuming that a number meaningful to another analytic or interface has the same meaning here. Construct the supported update without changing unrelated hardware settings.\n\n- Apply the approved plugin change and retrieve its settings again. Compare the readback with the intended update before evaluating acoustic behavior. Use the owner’s authorized harmless input and an appropriate observation window for the separate functional check. If configuration or behavior is unresolved, retain the discrepancy and use the supported restoration process instead of experimenting across several plugins simultaneously.\n\n## Verification and evidence\n\nRetain the schema revision or complete returned schema, exact plugin path, previous and requested settings, sanitized operation result and readback. Keep acoustic observations separately attributed to the actual test conditions. Have a reviewer explain the chosen unit and limit from the correct schema rather than from memory.\n\nInclude a proposed desk case with a property copied from a different plugin and require the reviewer to identify the mismatch. Record actual outcomes only after the approved pilot. This article supplies no universal threshold, supported-plugin inventory or measured classification or detection accuracy.\n\n## Official references\n\n- [Audio Analytics](https://developer.axis.com/vapix/audio-systems/audio-analytics/) — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings." }, "json_ld": { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://dsesecurity.com/#organization", "name": "Detection Systems & Engineering", "alternateName": "DSE Security", "url": "https://dsesecurity.com/", "logo": { "@type": "ImageObject", "url": "https://update.dsesecurity.com/assets/dse-logo-20260812.png?v=1.8.20" } }, { "@type": "Organization", "@id": "https://update.dsesecurity.com/#editorial-team", "name": "DSE Security Editorial Team", "url": "https://update.dsesecurity.com/", "parentOrganization": { "@id": "https://dsesecurity.com/#organization" } }, { "@type": "WebSite", "@id": "https://update.dsesecurity.com/#website", "name": "DSE Updates", "alternateName": "DSE Security Knowledge Hub", "url": "https://update.dsesecurity.com/", "inLanguage": "en-US", "publisher": { "@id": "https://dsesecurity.com/#organization" }, "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://update.dsesecurity.com/?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@type": "WebPage", "@id": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/", "url": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/", "isPartOf": { "@id": "https://update.dsesecurity.com/#website" }, "lastReviewed": "2026-10-29" }, { "@type": "BreadcrumbList", "@id": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/#breadcrumbs", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "DSE Updates", "item": "https://update.dsesecurity.com/" }, { "@type": "ListItem", "position": 2, "name": "IT", "item": "https://update.dsesecurity.com/topic/it/" }, { "@type": "ListItem", "position": 3, "name": "Read the Axis audio plugin schema before changing its settings", "item": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/" } ] }, { "@type": [ "Article", "TechArticle" ], "@id": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/#article", "identifier": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/", "url": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/", "headline": "Read the Axis audio plugin schema before changing its settings", "description": "Read the actual Axis audio plugin schema and current settings together before editing a plugin.", "abstract": "Read the actual Axis audio plugin schema and current settings together before editing a plugin. Do not copy property names, units or limits from another plugin’s example.", "articleBody": "Bottom line: Use the installed plugin’s own schema as the setting contract. Keep the exact device, input or output and plugin identity together so a familiar threshold name does not substitute for the correct property definition.\nSource fact: documented behavior\nAxis’s Audio Analytics gives each audio plugin its own settings object and provides getPluginsSchemas to describe those settings.\ngetPluginsSettings retrieves configured audio-plugin settings across audio sources; the source says their properties are plugin specific and defined by the returned JSON schema.\nThe documentation separates Audio Analytics configuration from Audio Device Control, which configures the hardware devices.\nWhat the source does not establish\nDo not infer that two plugins share property names, units, valid ranges or detection performance. Treat sample settings as examples rather than a compatibility list. Keep microphone power and other hardware changes outside this plugin-setting procedure, and do not describe a valid settings object as proof of an accurate analytic result.\nApplicability questions\n\nWhich installed plugin and actual input or output are being changed?\nWhich schema describes that exact plugin’s settings?\nWhat current property, type, unit and permitted value are relevant?\nWhat approved acoustic observation will assess the intended result separately from configuration acceptance?\n\nDSE recommendation: controlled next steps\nThe following steps are DSE recommendations based on the cited source.\nDSE recommends reviewing the current settings against the matching plugin schema before constructing an update.\n\nRetrieve the supported schema and settings responses from the target device. Match the device, input or output and plugin identifiers before reviewing individual properties. Record the intended change and preserve the current settings. If the plugin or property cannot be matched to its schema, stop and resolve that identity issue rather than borrowing a nearby example.\nHave the integration owner review the selected property’s type, limits and description from the actual schema. Use a harmless proposed value within the documented requirements for a pilot. Keep unit interpretation explicit; avoid assuming that a number meaningful to another analytic or interface has the same meaning here. Construct the supported update without changing unrelated hardware settings.\nApply the approved plugin change and retrieve its settings again. Compare the readback with the intended update before evaluating acoustic behavior. Use the owner’s authorized harmless input and an appropriate observation window for the separate functional check. If configuration or behavior is unresolved, retain the discrepancy and use the supported restoration process instead of experimenting across several plugins simultaneously.\n\nVerification and evidence\nRetain the schema revision or complete returned schema, exact plugin path, previous and requested settings, sanitized operation result and readback. Keep acoustic observations separately attributed to the actual test conditions. Have a reviewer explain the chosen unit and limit from the correct schema rather than from memory.\nInclude a proposed desk case with a property copied from a different plugin and require the reviewer to identify the mismatch. Record actual outcomes only after the approved pilot. This article supplies no universal threshold, supported-plugin inventory or measured classification or detection accuracy.\nOfficial references\n\nAudio Analytics — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.", "datePublished": "2026-10-29T19:49:53+00:00", "dateModified": "2026-10-29T19:50:08+00:00", "mainEntityOfPage": { "@id": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/" }, "inLanguage": "en-US", "isAccessibleForFree": true, "author": { "@type": "Organization", "name": "DSE Security Editorial Team", "url": "https://update.dsesecurity.com/#editorial-team" }, "publisher": { "@id": "https://dsesecurity.com/#organization" }, "image": { "@type": "ImageObject", "@id": "https://update.dsesecurity.com/updates/read-the-axis-audio-plugin-schema-before-changing-its-settings/#primaryimage", "url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20", "contentUrl": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20", "width": 1200, "height": 630, "caption": "Read the Axis audio plugin schema before changing its settings" }, "articleSection": [ "IT", "Video Surveillance" ], "keywords": [ "IT", "Video Surveillance", "Guide", "Advisory priority" ], "genre": "Guide", "about": [ { "@type": "Thing", "name": "IT", "url": "https://update.dsesecurity.com/topic/it/" }, { "@type": "Thing", "name": "Video Surveillance", "url": "https://update.dsesecurity.com/topic/video-surveillance/" } ], "wordCount": 524, "timeRequired": "PT3M", "publishingPrinciples": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/", "usageInfo": "https://update.dsesecurity.com/usage/", "copyrightHolder": { "@id": "https://dsesecurity.com/#organization" }, "copyrightNotice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.", "citation": { "@type": "CreativeWork", "name": "Axis Communications — Audio Analytics", "url": "https://developer.axis.com/vapix/audio-systems/audio-analytics/" } } ] } }