My scripts don't work in QuickLook

🌵 Needle Engine
1

Hi,
I’m developing some projects in WebAR with Needle but none of the scripts I create work in QuickLook, they only work in the browser or in WebAR on Android. In fact, I have followed this video (https://www.youtube.com/watch?v=uf5UK0bLHlY&ab_channel=Needle) step by step and the same thing happens, the script works in the browser but not in QuickLook. Could you help me solve it?

Thanks,

2

Hi Juan Sebastian Duque Alvarez,

It seems that you’re experiencing issues with your scripts not functioning properly in QuickLook while they work in the browser and on Android WebAR.

Here are some potential reasons and suggestions:

  1. Compatibility: QuickLook has certain limitations and does not support all functionalities available in browsers. Make sure your scripts are compatible with the interactive USDZ formats.

  2. Animation Overlap: There’s a known issue with overlapping animations in QuickLook (FB13410767), which can cause one animation to stop playing when another starts. If multiple animations are being triggered on the same object, ensure exclusive playback is properly managed (see the documentation) (see the documentation).

  3. Exporting Settings: Ensure that you’re using the USDZExporter with the interactive option enabled. This setting will allow QuickLook-specific behaviors to be exported correctly (see the documentation).

  4. Debugging:

    • Use logging to verify that your scripts are being invoked as expected.
    • Ensure there are no JavaScript errors in the console that may cause the execution to stop.

  5. Animations and Audio: If you have any audio clips or animations that are set to play automatically, check that they are correctly set up in the exporter. QuickLook has bugs concerning immediate playback characteristics, which can prevent audio from behaving as expected (see the documentation).

  6. Test Different Devices: Sometimes, QuickLook behavior can differ between devices or iOS versions, so testing on different devices can help isolate the problem.

You might also want to refer to the Needle Engine Documentation for more details on handling QuickLook and exporting USDZ files effectively.

If possible, provide information about the specific setup you are using or logs that might give more context regarding the issue, including any specific components that may not be working.

Feel free to ask if you need more specific guidance!

3 replies left
thread_IUPBS1tQ5eD8hb18wjWrfGYk
Reply to this message to continue the conversation

3

Hello Juan

please refer to the Everywhere Actions documentation for interactive Quicklook apps and make sure your scripts are implemented accordingly (or use our pre-built actions)

4

Hello Marcel, we already tried to implement what it says in the documentation and create a new custom action from the IBehaviorElement interface, to be able to add it correctly in BehaviorModel

implementation script creating a BehaviorModel that is activated with TriggerBuilder.tapTrigger:

WhatsApp Image 2024-10-17 at 08.06.43_f7631346
WhatsApp Image 2024-10-17 at 08.06.43_f76313461349×583 88.7 KB

Custom behavior that is trying to be implemented using IBehaviorElement:

2
21271×542 76.3 KB

5

Unfortunately this is not possible the way you implemented it. Apple doesnt give us as much flexibility in Quicklook and interactions are limited to predefined behaviours (this is a restriction by Apple) You can see the supported actions here: Actions and triggers | Apple Developer Documentation

This is how you can emit those for your USDZ in Needle Engine:

So you have to get a bit creative if you want to implement a scoring system in Quicklook