Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note

Need to insert links to relevant API parts in text and/or as “See also” section.

Troubleshooting

...

The following articles describe the various error codes produced by the Visage Technologies licensing system, and what may be done to remedy each error. They are valid for visage|SDK version 8.6b1 and higher.

Error code 0x00000001 (VS_ERROR_INVALID_LICENSE)

The error you received indicates that the issued license is not valid. The error occurs when the BundleID is not the same as the one in your application, or when license that is registered to one product is used with another product. Can you please check if you’re using the correct license?

Error code 0x00000002 (VS_ERROR_EXPIRED_LICENSE)

The error you received indicates that the issued license has expired. Would you be interested in renewing your license?

Error code 0x00000004 (VS_ERROR_EARLIER_VERSION_LICENSE)

The error you received indicates that the license version you are using is out of date, so you would need to update to the newest available version. Would you be interested in updating your license?

Error code 0x00000008 (VS_ERROR_MISSING_KEYFILE)

The error you received indicates that the application cannot locate license key file. Please verify that the license key file is present in the folder used as a path to initialize license manager. For more details please follow the instructions from Documentation -> Licensing.

Error code 0x00000010 (VS_ERROR_NO_LICENSE)

The error you received indicates that there is currently no license available. Please follow the instructions from Documentation -> Licensing on how to correctly use the license key in your application.

Error code 0x00000020 (VS_ERROR_CORRUPT_VERSION_STRING)

The error you received indicates that the license keys were somehow modified. Please try using a clean copy of the license key that was sent to you to see if the error still occurs.

Error code 0x00000040 (VS_ERROR_LICENSE_VALIDATION_FAILURE)

The error you received indicates that the server has rejected the license. This was because <reason>.

[Internal] - Check on the VTLS server for the reason why license was rejected. It can be one of the following (the most common being -6):

  • -1 - License Key sent to VTLS server for validation was malformed

  • -2 - Device ID sent to VTLS server for validation was malformed

  • -3 - License does not exist on VTLS server

  • -4 - License is blocked on VTLS server

  • -5 - License expired

  • -6 - Installations limit reached

  • -7 - Concurrent users limit reached

Error code 0x00000080 (VS_ERROR_NC_CONNECTION_FAILED)

The error you received indicates that there was a failure in connection to our licensing server. Can you please let me know if you want to use offline or online activation?

...

I am using visage|SDK FaceRecognition gallery with a large number of descriptors (100.000+) and it takes 2 minutes to load the gallery. What can I do about it?

visage|SDK FaceRecognition simple gallery implementation was not designed for a use case with a large number of descriptors.

Use API functions that provide raw descriptor output (extractDescritor) and descriptor similarity comparison function (descriptorSimilarity) to implement your own gallery solution in technology of your choice is appropriate for your use case.

Note

Need to insert links to relevant API parts in text and/or as “See also” section.

I want to change the camera resolution in Unity application VisageTrackerDemo. Is this supported and how can I do this?

Depending on the platform it’s already possible, out of the box.

On Windows and Android, the camera resolution can be changed via Tracker object properties defaultCameraWidth and defaultCameraHeight within the Unity Editor. When the default value -1 is used, the resolution is set to 800 x 600 in the native VisageTrackerUnityPlugin.

On iOS it’s not possible to change the resolution out of the box from the demo application. The camera resolution is hard-coded to 480 x 600 within the native VisageTrackerUnityPlugin.

VisageTrackerUnityPlugin is provided with full source code within the package distribution.

I am getting EntryPointNotFoundException when attempting to run a Unity application in the Editor. Why does my Unity application does not work?

Make sure that you have followed all the steps from the documentation Building and running Unity application.

Note

Need to insert links to relevant API parts in text and/or as “See also” section.

Verify that the build target and visage|SDK platform match. For example, running visage|SDK for Windows inside the Unity Editor and for a Standalone application will work since both are run on the same platform. Attempting to run visage|SDK for iOS inside the Unity Editor on a MacOS will output an error because iOS architecture does not match MacOS architecture.

Troubleshooting - Licensing Errors

The following articles describe the various error codes produced by the Visage Technologies licensing system, and what may be done to remedy each error. They are valid for visage|SDK version 8.6b1 and higher.

Error code 0x00000001 (VS_ERROR_INVALID_LICENSE)

The error you received indicates that the issued license is not valid. The error occurs when the BundleID is not the same as the one in your application, or when license that is registered to one product is used with another product. Can you please check if you’re using the correct license?

Error code 0x00000002 (VS_ERROR_EXPIRED_LICENSE)

The error you received indicates that the issued license has expired. Would you be interested in renewing your license?

Error code 0x00000004 (VS_ERROR_EARLIER_VERSION_LICENSE)

The error you received indicates that the license version you are using is out of date, so you would need to update to the newest available version. Would you be interested in updating your license?

Error code 0x00000008 (VS_ERROR_MISSING_KEYFILE)

The error you received indicates that the license keys were somehow modified. Please try using a clean copy of the license key that was sent to you to see if the error still occurs.

...

application cannot locate license key file. Please verify that the license key file is present in the folder used as a path to initialize license manager. For more details please follow the instructions from Documentation -> Licensing.

Error code 0x00000010 (VS_ERROR_NO_LICENSE)

The error you received indicates that there is currently no license available. Please follow the instructions from Documentation -> Licensing on how to correctly use the license key in your application.

Error code 0x00000020 (VS_ERROR_CORRUPT_VERSION_STRING)

The error you received indicates that the license keys were somehow modified. Please try using a clean copy of the license key that was sent to you to see if the error still occurs.

Error code

...

0x00000040 (VS_ERROR_

...

LICENSE_VALIDATION_

...

FAILURE)

The error you received indicates that the date on the computer was modified. Please make sure the date on the computer is correct.

Error code 0x00000800 (VS_ERROR_UNREADABLE_KEYSTRING)

The error you received indicates that the license keys were somehow modified. Please try using a clean copy of the license key that was sent to you to see if the error still occurs.

...

server has rejected the license. This was because <reason>.

[Internal] - Check on the VTLS server for the reason why license was rejected. It can be one of the following (the most common being -6):

  • -1 - License Key sent to VTLS server for validation was malformed

  • -2 - Device ID sent to VTLS server for validation was malformed

  • -3 - License does not exist on VTLS server

  • -4 - License is blocked on VTLS server

  • -5 - License expired

  • -6 - Installations limit reached

  • -7 - Concurrent users limit reached

Error code 0x00000080 (VS_ERROR_NC_CONNECTION_FAILED)

The error you received indicates that your license key does not support the platform on which you are trying to use it on. Can you please let me know on which platforms you'd like to use visage|SDK?

Error code 0x00002000 (VS_ERROR_INVALID_URL)

The error you received indicates that the license was issued for a different domain, can you please confirm the domain name on which you want to use the visage|SDK?

Troubleshooting

I am using visage|SDK FaceRecognition gallery with a large number of descriptors (100.000+) and it takes 2 minutes to load the gallery. What can I do about it?

visage|SDK FaceRecognition simple gallery implementation was not designed for a use case with a large number of descriptors.

Use API functions that provide raw descriptor output (extractDescritor) and descriptor similarity comparison function (descriptorSimilarity) to implement your own gallery solution in technology of your choice is appropriate for your use case.

Note

Need to insert links to relevant API parts in text and/or as “See also” section.

I want to change the camera resolution in Unity application VisageTrackerDemo. Is this supported and how can I do this?

Depending on the platform it’s already possible, out of the box.

On Windows and Android, the camera resolution can be changed via Tracker object properties defaultCameraWidth and defaultCameraHeight within the Unity Editor. When the default value -1 is used, the resolution is set to 800 x 600 in the native VisageTrackerUnityPlugin.

On iOS it’s not possible to change the resolution out of the box from the demo application. The camera resolution is hard-coded to 480 x 600 within the native VisageTrackerUnityPlugin.

VisageTrackerUnityPlugin is provided with full source code within the package distribution.

I am getting EntryPointNotFoundException when attempting to run a Unity application in the Editor. Why does my Unity application does not work?

Make sure that you have followed all the steps from the documentation Building and running Unity application.

Note

Need to insert links to relevant API parts in text and/or as “See also” section.

Verify that the build target and visage|SDK platform match. For example, running visage|SDK for Windows inside the Unity Editor and for a Standalone application will work since both are run on the same platform. Attempting to run visage|SDK for iOS inside the Unity Editor on a MacOS will output an error because iOS architecture does not match MacOS architecture.there was a failure in connection to our licensing server. Can you please let me know if you want to use offline or online activation?

Error code 0x00000100 (VS_ERROR_TEMPERED_KEYFILE)

The error you received indicates that the license keys were somehow modified. Please try using a clean copy of the license key that was sent to you to see if the error still occurs.

Error code 0x00000200 (VS_ERROR_TEMPERED_KEYSTRING)

The error you received indicates that the license keys were somehow modified. Please try using a clean copy of the license key that was sent to you to see if the error still occurs.

Error code 0x00000400 (VS_ERROR_TEMPERED_DATE)

The error you received indicates that the date on the computer was modified. Please make sure the date on the computer is correct.

Error code 0x00000800 (VS_ERROR_UNREADABLE_KEYSTRING)

The error you received indicates that the license keys were somehow modified. Please try using a clean copy of the license key that was sent to you to see if the error still occurs.

Error code 0x00001000 (VS_ERROR_INVALID_OS)

The error you received indicates that your license key does not support the platform on which you are trying to use it on. Can you please let me know on which platforms you'd like to use visage|SDK?

Error code 0x00002000 (VS_ERROR_INVALID_URL)

The error you received indicates that the license was issued for a different domain, can you please confirm the domain name on which you want to use the visage|SDK?