To sign in to Spark AR Studio:
To delete something, right-click on it and select Delete from the menu.
To rename something:
To resize something:
You can also adjust objects in the Viewport directly by toggling between the Manipulator buttons in the Toolbar and moving the axis.
To make an object track your face, you have to make it the child of a Face Tracker.
To do this:
Note: To insert objects as children of other objects directly, you can also right-click on the parent in the Scene tab, select Insert and then select the object you want to insert from the menu.
You can add more than one face tracker to a scene, but you can’t add more than one to a face. You would add more than one face tracker if you wanted to track multiple faces within a scene.
To enable multiple faces:
The Viewport enables to you position, scale and rotate your objects in a 3D space, but it isn't an accurate preview of the output. That's why we have the Simulator Window.
The Simulator Window is a separate view for previewing the output of any changes you make in the Viewport and is an accurate representation of what the effect will look like on your device.
The Viewport and the Simulator Window are designed to be used in sync, but if you want to hide either one, you can.
Docking the Simulator Window will maximize it and hide the Viewport. To dock the Simulator Window, click on it to show the buttons and click the third one from the left.
To hide the Simulator window, go to View in the navigation bar and click Hide Simulator.
If you have more than one camera input available (a camera on a laptop and one on a connected monitor, for example) you can choose which one Spark AR Studio uses. To do this, long-press on Video in the Toolbar and select the camera you want to use from the menu.
To test the effects you build in Spark AR Studio on the Spark AR Player app, you'll need:
To test your effect:
The Spark AR Player app stores a version of your effect whenever you click Mirror in the Spark AR Studio Toolbar. This means you can view effects that you've mirrored on your device previously, without being connected to your computer or the Internet.
Yes, if you're offline, you can still view effects that you mirrored with the Spark AR Player app previously.
To toggle between versions of your effect:
The Mirror button in Spark AR Studio is grayed out unless a mobile device is connected to your computer via a USB cable.
If you're having trouble previewing your effect with the Spark AR Player app, make sure:
Instagram and Messenger are currently in closed beta - available to select partners only.
ShareDialog supports an API
canShow(ShareContent shareContent) that returns a boolean value which can be used to verify if the camera share is supported by the current version of Facebook app.
FBSDKShareDialog supports the API
canShow:shareContent that returns a boolean value which can be used to verify if the camera share is supported by the either the current version of Facebook app.
When it was first built, Spark AR Studio had its own units of measurement. These units were similar to millimeters.
From Spark AR Studio v25 onwards, these units will no longer be supported and real-world units, like centimeters or inches, will be supported instead. This will help make the dimensions that you specify in your projects look as close to real-world dimensions as possible.
From v25, you'll be able to choose the units you want to use in the properties of each project. The units that you select will affect how the numeric values of object properties and numbers in your scripts are interpreted.
Older projects will be automatically migrated when you open them in AR Studio v25. The Units of Measurements setting for these projects will be set to Legacy Units, so the numeric values of object properties in those projects won't change.
This change affects all 3D object properties that are specified in world space (example: size and position) and, most importantly, translation transform components. Any 3D objects in migrated projects will be automatically rescaled to meters, which may result in errors.
If your migrated project contains a 3D object, please make sure that you test for and fix any problems that might have occurred. Imported 3D objects are mostly likely to break, especially if the scale values of those objects are referenced in the script.
Your objects might look a little different in relation to the screen of the mobile device than they did before the migration, but this will depend on the mobile device that you use. An object of a certain size may take up the entire screen on one mobile device but not on another one. If you need to make sure that 3D objects are displayed in a fixed way relative to the screen, then those objects should be sized dynamically, either in the script or through layout mechanisms.
The units of measurement migration won't affect the properties of 2D objects. This is because the values of those properties are specified in screen units.
There are 2 ways to adjust a 3D object that has broken because of the units of measurement migration.
Your script will reference the null object instead of the 3D mesh. By default, the scale values of the null object are set to 1, 1, 1, so the scaling in your script should work as it did before your project was migrated.
Transform.scaleX/scaleY/scaleZbecause those places might include values that are used in animations.
960, as this is the factor that is used internally to transform legacy units into meters. However, in many cases, you might prefer to divide by
1000, so that you end up with round numbers.
Here is an example from one of our projects:
var startScale = 7; ... var driver = Animation.yoyoTimeDriver(2500); var sampler = Animation.samplers.easeInOutSine(startScale*0.8, startScale*1.2); star.transform.scaleX = Animation.animate(driver, sampler); star.transform.scaleY = Animation.animate(driver, sample); driver.start();
In this case, the size of an element is animated to produce a pulsing star. After opening this project in AR Studio v25, this start turned out to be too big and it took up the whole screen.
To fix this project, we just need to update the
var startScale = 0.007;
We chose to divide it by
1000 as we didn't need the new size to match the previous one.
From v37, the face mesh in Spark AR Studio will be upgraded to a higher fidelity face mesh.
In this new version, we have improved the accuracy of facial feature tracking.
When you open existing projects in Spark AR Studio v37, the face mesh will be updated to the new version automatically.
However, to make sure that your project continues to work as expected, you'll need to recreate any existing deformation models to accommodate the new mesh.
To download a copy of the reference mesh and texture templates: