Petnow LogoPetnow

Capture Guide

Tips you can hand to your users so their nose and face scans succeed, and how to map the SDK's live feedback to on-screen messages.

Your users scan their pets, not you, so they need short, clear instructions. The tips below are written for them: copy them into your app, help pages or onboarding as they are, or adapt the wording. The second part is for your developers.

Petify's Web Integration pages already show live guidance on the capture screen. You can still put these tips on your own page before you send the user there. Web Integration supports dogs only, so the cat tips apply to the mobile SDKs.

Tips for your users

Dogs: scanning the nose

  1. Find bright, even light. Daylight indoors or open shade works best. Avoid direct sunlight, a camera flash, or a lamp right above the nose: light reflecting off the nose hides the nose print.
  2. Dry the nose. A wet, shiny nose reflects light. Gently pat it dry just before scanning.
  3. Start a little away, then come closer slowly. Hold the phone about 30 cm (one foot) from the nose, then bring it closer slowly until the app stops asking you to move closer. For most dogs this ends up about 15–25 cm away; for small dogs, closer. If the picture turns blurry, you are too close: move back a little.
  4. Face the nose straight on. Hold the phone level with the nose, not from above or from the side.
  5. Hold still for a moment. Once the nose is in the guide, keep the phone steady for a second or two while the scan completes. Moving slowly works better than moving quickly.
  6. Keep your dog calm. Short sessions work best. A treat, or the app's sounds, help hold your dog's attention and keep its head still.

If a scan fails, follow the message on the screen, change the light or dry the nose, and try again.

Cats: scanning the face

These tips apply to the mobile SDKs only. Web Integration does not support cats.

  1. Face to face. Hold the phone at your cat's eye level so the face looks straight at the camera, with both eyes visible. A face turned to the side, up or down is not accepted.
  2. Fill the screen with the face. Come close enough that the face covers at least a third of the screen's width.
  3. Bright, even light, and hold still for a moment, as for dogs.

For integrators

Show the SDK's live feedback

While the user is aiming, the SDK reports why the current frame is not usable yet (onDetectionStatus). Turning those reports into short messages helps far more than a static tip. A suggested mapping:

Status (Android / iOS)Suggested message
TooFarAway / .tooFarAway"Move closer to the nose."
DefocusedBlurDetected / .defocusedBlurDetected"Too close or out of focus. Move back a little and hold still."
MotionBlurDetected / .motionBlurDetected, TooBlurred / .tooBlurred"Hold the phone still."
TooDark / .tooDark"Find a brighter spot."
TooBright / .tooBright"Too bright. Move out of direct light."
GlareDetected / .glareDetected"Light is reflecting on the nose. Dry the nose or change the angle."
ShadowDetected / .shadowDetected"There's a shadow on the nose. Find even light."
NotFrontNose, NotFrontNoseTop / .notFrontNose, .notFrontNoseTop"Hold the phone level with the nose."
NotFrontCatFaceHor, NotFrontCatFaceTop, NotFrontCatFaceBottom / .notFrontCatFaceHor, .notFrontCatFaceTop, .notFrontCatFaceBottom"Face your cat straight on, at eye level."
NoseNotFound / .noseNotFound"Point the camera at the nose."

React Native and Flutter pass the same reasons. See Basic Usage for each platform: Android · iOS · React Native · Flutter.

From SDK 1.6.0 the preview appears before detection is ready. Start showing guidance when detection statuses arrive, not when the preview appears.

Why the distance is closer than you might expect

The SDK accepts a dog nose once it is at least about 256 pixels across in the 4K camera frame. With a typical phone camera that means roughly 15–25 cm for a medium-sized nose, closer for small dogs and a little further for large ones. Further away, the SDK reports TooFarAway; closer than the camera can focus (about 10–20 cm depending on the phone), the image goes soft and the SDK reports DefocusedBlurDetected. Phones that record only 1080p need to be closer still. Telling users to start a little away and come closer slowly lets them find that range for their own dog and phone.

On Pro iPhones with a triple camera, SDK 1.6.0 switches to the Ultra Wide camera for noses closer than the main camera can focus, so very close scans can still come into focus.

Registering and checking again

  • Capture registration and later scans in similar conditions (light, angle, distance). A pet registered in good light and verified in poor light scores lower.
  • If a registration looked weak (blurry or dark images), it is better to scan again in good conditions than to keep it.

On this page