The installation and configuration of AEM 3D (version 3.0) involves the following:
See also Working with 3D assets.
See also AEM 3D Assets release notes for prerequisites, supported browsers, and other important release imformation.
See also Working with the 3D Sites component.
Before downloading and installing the 3D package, make sure that you have installed all prerequisite AEM packages successfully. See the AEM 3D Release Notes.
The native AEM 3D code requires the Autodesk FBX library to support the FBX file format. (Adobe is currently unable to redistribute this library.)
See also Advanced configuration settings.
Log onto the host where AEM is installed.
Use the link appropriate for your operating system to download FBX SDK version 2016.1.2
Install the FBX SDK:
<yourFBXSDKpath>/Install_FbxFileSdk.txt. Install the SDK to
Before you proceed with the installation and configuration of AEM 3D, Adobe recommends that you deploy any applicable service packs and other related feature packs. See AEM 3D Release Notes.
See also Advanced Configuration Settings.
To install the native 3D code package:
Do one of the following:
Ensure that you have a supported browser available to access AEM.
See System requirements.
Access Software Distribution portal. Locate version 3.0.1 of
AEM-6.4-DynamicMedia-3D feature pack and download it.
In AEM, click Tools > Administration > Deployment > Package Manager.
Upload the downloaded feature pack to AEM. Locate it and click Install.
In the Install Package dialog box, expand Advanced Settings, then set Access Control Handling to Merge.
Click Install to begin installation of the package.
sample-3D-content.zip is placed in the Assets root folder. See Validating the setup of AEM 3D for additional information.
To configure the 3D asset ingestion workflow:
In AEM, click the AEM logo to access the global navigation console, then click the Tools icon and navigate to Workflow > Models.
On the Workflow Models page, hover over the DAM Update Asset workflow, and when the check mark appears, select it.
On the toolbar, click Edit.
On the DAM Update Asset screen, in the AEM floating panel, click the Plus icon to the right of Workflow to expand the list. Select Process Step in the list.
Drag Process Step and drop it into the workflow just before DAM Update Asset Workflow Completed component near the end of the workflow.
Double-click the newly added process step.
In the Step Properties dialog box, under the Common tab, in the Title field, enter a suitable description for the process such as
Process 3D content.
Click the Process tab.
From the Process drop-down menu, select Geometric 3D Object Service, then select the Handler Advance check box.
Near the upper-right corner of the dialog box, click the check mark icon to return to the DAM Update Asset page.
Near the upper-right corner of the DAM Update Asset page, click Sync to save the edited workflow model.
After restart, you are ready to upload 3D content and have AEM process it.
Continue with Validating the setup of AEM 3D.
In AEM, click Tools > Assets, then download
sample-3D-content.zip, and expand the downloaded file. (You can now delete
sample-3D-content.zip in AEM.)
Make sure you are in Card View to view upload and processing feedback in the remaining steps.
Create a folder named
test3d to receive test content.
Upload all files from
sample-3D-content/images to the
Wait for the upload and processing to complete. You may need to refresh your browser.
Upload the three
.fbx files from
sample-3D-content/ to the
Do not upload the .ma model files yet.
In the Card View, observe the message banners that are shown on the 3d asset cards.
Each asset proceeds through several processing steps. When the Creating Preview… processing step completes, the card is updated with a thumbnail image. When final processing is completed, the banner is replaced with the NEW indicator.
Expect very high CPU utilization while 3D processing is in progress. Depending on available CPU capacity it may take a substantial amount of time to complete all processing.
You will now learn how to resolve file dependencies.
On the Unresolved Dependencies banner for the
stage-helipad.fbx card, click the Exclamation Point icon to navigate to the asset’s properties and open the Dependencies tab.
Click the Folder/Magnifying Glass icon to the right of the file name to open the asset browser and resolve the dependencies as follows:
Click Save and Close to finish processing the asset and return to the Card View, respectively.
When processing is complete, you see the following in Card View:
On the test3d page, click the
logo-sphere.fbx card to open the model in Detail View.
Near the upper-right corner of the logo-sphere.fbx page, click the Stage Spotlight icon to expand the drop-down menu, then select
From the Stage Spotlight drop-down list, select
Using the left mouse button to adjust the view. The background and model lighting changes to reflect the new stage selection.
This configuration task is optional.
You can optionally configure support in AEM 3D for Adobe Dimension assets.
You must configure an external conversion service to allow ingestion, preview, and publishing of Adobe Dimension 3D assets in AEM. The service converts from the proprietary Adobe Dimension (
.dn) format to a variant of glTF (formatted as a
.glb file) which is saved with the Dn asset as a rendition. The
.glb rendition is used for web-based viewing of the 3D asset in AEM Assets, Sites, and Screens, and is also available for downloading for use with third-party applications.
The conversion service is hosted by Adobe in Amazon AWS. After properly configuring the service,
.dn files uploaded to AEM are then copied securely to the conversion service by way of temporary storage in Amazon S3. The conversion result is transferred back to AEM by way of temporary S3 storage. All transfers and storage are secured. Also, the content persists in S3 and the conversion service only briefly (typically no more than a few minutes).
To configure suoport for Adobe Dimension assets:
Contact your Adobe AEM account manager, provisioning expert, or support representative to request credentials for AEM3D Services.
Only one set of credentials is required for each organization, regardless of the number of AEM instances on which the credentials are installed.
Verify that you have received the following information:
As Administrator, log into your AEM author instance where you want the credentials installed, then open CRXDE Lite.
Configure the new credentials information by doing the following in CRXDE Lite:
/libs/settings/dam/v3D/services/dncrand set the
clientIdproperty to the new value.
/libs/settings/dam/v3D/services/awsand set the
userPoolIdproperties to the new values.
encryptedPasswordproperty. This value is automatically encrypted when you tap Save All.
encryptedPasswordproperty shows a different string enclosed by curly braces. This appearance indicates that the password is properly encrypted and secure.
Specify the format of the
.glb conversion rendition by doing the following in CRXDE Lite:
/libs/settings/dam/v3D/services/dncr in CRXDE Lite.
outputFormat property to either
When set to
.glb conversion includes Adobe-specific extensions, such as IBL lighting, for best quality when viewing Dn assets in AEM. However, the converted .glb rendition may not render well in third-party applications.
When set to
.glb rendition is generic without Adobe-specific extensions. This setting allows it to be used in third-party applications, while viewing with the AEM 3D viewer will be visually sub-optimal.
Enable the Dn file format by doing the following in CRXDE Lite:
Enabledproperty to true.
Validate the configuration by doing the following:
Open AEM Assets.
logo_sphere.dn to the
test3d folder. The file is located in
sample-3D-content.zip was previously downloaded for validating the basic 3D functionality.
Return to the Card View and observe the message banner shown on the uploaded asset. The Converting Format… banner is displayed while the conversion process is in progress.
After all processing is complete, open the asset in Detail View to verify that the converted asset is displayed correctly and that the viewer’s navigation controls are usable.
If a “Processing Error” is displayed on the Dn asset in the Card View after 10-15 minutes, the conversion failed.
If such case, you can troubleshoot the conversion by doing the following: