Prepare a Try-On Model
Configure each ring before you add Try-On to a website. The configuration controls the ring size, position, and rotation on the tracked finger. It also tells Mini Viewer that Try-On is available for the model.
Before you start
Make sure that the ring model is available in your Drive inside iJewel3D Platform. The model must have a clear inner opening. Auto Fit uses this opening to calculate the initial fit.
Enable Try-On
- Open the model from your Drive in the iJewel3D editor.
- Open the Try-On settings.
- Turn on Enable AR.
- Select Enter Setup.
Setup mode displays a cylinder inside the ring. The cylinder represents the tracked finger.
Fit the ring to the cylinder
Select Auto Fit first.
Auto Fit finds the inner ring opening and provides an initial position and size. If Auto Fit finds several openings, select it again to inspect the next result.
Use these controls to correct the result:
| Control | Use |
|---|---|
| Model Size | Match the inner ring opening to the cylinder diameter. |
| Position | Place the center of the ring opening on the cylinder axis. |
| Rotation | Align the ring band with the cylinder. Point the ring head in the direction of the arrow. |
| Front, Top, and Side | Inspect the fit from fixed viewpoints. |
| X 90°, Y 90°, and Z 90° | Correct the model orientation. Use these controls for large corrections. |
The cylinder must pass through the center of the ring opening. The band must surround the cylinder evenly. The cylinder must pass through the center of the ring opening. The band must surround the cylinder evenly. The arrow inside the cylinder shows the correct direction for the ring head.
Check the fit from all three viewpoints. Rotate the model until the ring head points in the direction of the arrow.
Preview and save
- Select Exit Setup.
- Select Preview in AR.
- Give the browser camera access.
- Check the ring size, position, and direction on your hand.
- Exit the preview.
- Correct the setup if the fit is wrong.
- Save the model to your Drive.
The saved model contains the Try-On configuration. You do not need to download or host a separate configuration file. Mini Viewer receives the model and its configuration through loadModelById.
Public file access
The file must be Public in its share settings. loadModelById cannot load a private file from your Drive.
Test the saved model
After you save the model, test its file ID with the Direct Integration example. The Mini Viewer Try-On button appears only when the saved configuration has Try-On enabled. If the old fit appears, save the model again and reload the product page.
See the complete platform workflow
This video shows the Try-On part of the complete iJewel Platform workflow.
Fix common fitting problems
| Problem | Correction |
|---|---|
| Auto Fit does not find the ring | Make sure that the inner opening is clear. Then adjust the model manually. |
| The ring is too large or too small | Correct Model Size. |
| The ring is not centered | Correct Position from the front, top, and side viewpoints. |
| The ring head does not point in the direction of the arrow | Correct Rotation. Use a 90-degree change when the model uses another axis. |
| The Try-On button is missing | Turn on Enable AR, save the model, and reload the product page. |