Prerequisites
- A working Android quickstart
- A compatible AR mask available through Cloud Filters
Obtain the mask
Select and download a compatible AR mask through Cloud Filters.
Apply it
NosmaiEffects.applyEffect(maskPath, new NosmaiEffects.EffectCallback() {
@Override public void onSuccess() {
// Update selected state after success.
}
@Override public void onError(String message) {
Log.e("Nosmai", message);
}
});
Remove it
NosmaiEffects.removeEffect(maskInfo);
Use the item returned by the Cloud Filter catalog.
Verify it worked
Test face loss, reacquisition, fast movement, glasses, partial occlusion, both cameras, and device rotation.
Common errors
| Symptom | Fix |
|---|---|
| Callback reports failure | Pass the successful Cloud Filter download result and verify compatibility |
| Mask is not selected in UI | Update selection only from apply success and pipeline state |
| Frame rate falls | Test the Cloud Filter at 720p and 30 FPS in a Release build |
