Picture in Picture restoration does not work when running as iPadOS app on macOS

[defagos]

Description of the problem

Picture in Picture restoration does not work when an iPadOS app is run on macOS.

The reason is that the PiP lifecycle is not consistent between platforms when restoring via the dedicated button:

• iOS, iPadOS, tvOS: restore, will stop, did stop
• iPadOS on macOS: will stop, restore, did stop

I suspect this is a macOS issue since the lifecycle is documented on tvOS when swapping players. This should be reported to Apple.

In the meantime it might be possible to fix the macOS behavior to make it consistent with iOS, iPadOS and tvOS. If not possible reliably then we should likely do nothing and wait for an official fix. Reliable means that all usual use cases should work on all platforms.

Relevant stack trace or log output

No response

Reproducibility

Always

Steps to reproduce

1. Open the demo.
2. Play the Fondue example.
3. Enable PiP.
4. Restore from PiP. PiP closes.

Library version

0.9.0

Operating system

macOS 14.3

Code sample

No response

Is there an existing issue for this?

• I have searched existing issues and found no similar bug report.

[defagos]

One tempting fix would be to set previousPresented to nil in the did stop method of Router but this does not work with all the use cases we have (e.g. normal to transition 360° via PiP). We probably should carefully study in which order the PiP delegate methods are called in all scenarios we have if we want to find whether a fix is possible or not. This order is namely different whether we are restoring via the dedicated button or by switching to another content.

[defagos]

The order is the following when restoring via the PiP overlay restoration button:

• iPhone / iPad device: restore, will stop, did stop
• iPad on macOS: will stop, restore, did stop