docs: Add detail to face recognition MQTT update docs #21942
+8
−4
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Clarify that the weighted average favors larger faces and higher-confidence detections, that unknown attempts are excluded, and document when name/score will be null/0.0.
`0.0` in JSON is just `0`.
Collaborator
|
Thanks for the PR. If the face recognition docs themselves are not clear on these cases, then I think I'd prefer to see those docs updated as MQTT is not the only place where this data is visible. Perhaps just some inline comments in the MQTT docs for both face recognition and LPR would be appropriate, as is done with the |
NickM-27
requested changes
Feb 9, 2026
Move scoring logic details to face recognition docs and keep MQTT reference concise with inline field comments and links.
Author
|
Simplified MQTT tracked_object_update docs with inline comments. Moved scoring logic details to face recognition docs (different PR) to keep MQTT reference concise with inline field comments and links. |
4 tasks
hawkeye217
requested changes
Feb 9, 2026
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Proposed change
Added documentation for the
frigate/tracked_object_updateFace Recognition Update payload in the MQTT docs, clarifying that the publishedscoreis a weighted average (favoring larger faces and higher-confidence detections), that attempts below unknown_score are excluded, and documenting the conditions under whichnameandscorewill benull/0.Type of change