Transition management

[sy6sy2]

A thread to discuss the wanted behavior of Kodi when the Apple TV change states.

WIP work

Branch: https://github.com/SylvainCecchetto/xbmc/tree/transition-management

Actuel behavior:

• If becomeInactive: pause media
• If becomeActive: unpause media
• If enterBackground: stop media
• If enterForeground: play previously stoped media
• No network background task

Future work:

• If enterBackground for less than 5 minutes, just pause the media and keep network up. After this time, stop the media and close network to prevent Kodi crash by tvOS

Examples of transitions (tested)

• App switcher:

  • Open app switcher --> applicationWillResignActive
  • Close app switcher --> applicationDidBecomeActive
  • If you open the app switcher and do nothing, it seems like it will remains open indefinitely
    

• Siri:

  • Open Siri --> applicationWillResignActive
  • Close Siri -->applicationDidBecomeActive
  • If you open Siri and do nothing, then Siri will close on its own after exactly 5 minutes
    

• Springboard:

  • Return to springboard by "TV" button --> applicationWillResignActive then applicationDidEnterBackground
  • Reopen Kodi from springboard or from app switcher --> applicationWillEnterForeground then applicationDidBecomeActive
    

• TopShelf:

  • User select item from TopShelf (no tested) --> applicationWillEnterForeground then applicationDidBecomeActive
    

• Control Center:

  • Long press on "TV" button to open the control center --> applicationWillResignActive
  • Click on "Menu" button from the control center --> applicationDidBecomeActive
  • If you open the control center and do nothing, then it will close on its own after exactly 1 minute
    

• Sleep:

  • Click on "Go to sleep" button from the opened control center
    • applicationDidBecomeActive then
    • applicationWillResignActive then
    • applicationDidEnterBackground
  • Wake up Apple TV with Kodi app as last open app
    • applicationWillEnterForeground then
    • applicationDidBecomeActive then
    • applicationWillResignActive then
    • applicationDidBecomeActive

Possible states of Kodi when a "transition" appears

• Nothing is played
• A "local" file is played
• A "network" file is played
• A PVR channel is played and timeshifting IS available
• A PVR channel is played and timeshifting IS NOT available

Suggestions

• applicationWillResignActive

  • Nothing is played --> Do nothing
  • A "local" file is played --> Pause it OR Only reduce volume
  • A "network" file is played --> Pause it OR Only reduce volume
  • A PVR channel is played and timeshifting IS available --> Pause it OR Only reduce volume
  • A PVR channel is played and timeshifting IS NOT available --> Do nothing OR Only reduce volume
    

• applicationDidEnterBackground We have 5 seconds, instead tvOS will terminate Kodi

  • Nothing is played --> Do nothing
  • A "local" file is played --> Pause it
  • A "network" file is played --> Pause it for 5 minutes, after that Stop it
  • A PVR channel is played and timeshifting IS available --> Pause it for 5 minutes, after that Stop it
  • A PVR channel is played and timeshifting IS NOT available --> Stop it
    

• applicationDidBecomeActive

  • Nothing was played --> Do nothing
  • A "local" file was played --> Resume
  • A "network" file was played --> Resume
  • A PVR channel was played and timeshifting IS available --> Resume or Start channel if more that 5 minutes
  • A PVR channel was played and timeshifting IS NOT available --> Start channel
  • We come from a TopShelf item --> Open the movie item details or play movie item
    

• applicationDidFinishLaunching

  • Fresh start of Kodi, just do what is specified in "Perform at startup" setting

It's quite possible (sure) that I made mistakes, please tell me if I'm wrong ;-).

What do you think? Let me know your opinion and I will update this post :-D

Source: https://stackoverflow.com/questions/16880791/is-applicationwillresignactive-ever-called-before-didfinishlaunchingwithoptions

[kambala-decapitator]

Overall I agree. Comments:

• Open app switcher: applicationWillResignActive (like in the flowchart)
• Return to springboard: applicationDidEnterBackground (like in the flowchart)
• Open Siri: probably applicationWillResignActive, needs testing
• Put Apple TV to sleep: probably applicationDidEnterBackground, needs testing

One point I'd alter:

applicationDidEnterBackground - A "network" file is played --> Stop it

I'd rather pause it, as user might return to the app fast enough. Then in this case on applicationWillEnterForeground we can check if a significant amount of time has passed (maybe possible to fetch timeout), in which case we reload the stream from network (as if it was stop -> play).

One more case to test: user selects something from top shelf after applicationDidEnterBackground --> either stop player and open movie details or replace currently playing item.

P.S. Pausing on applicationWillResignActive must save current time offset.

[sy6sy2]

Thank you for your comments, I updated the first post.

[kambala-decapitator]

User select item from TopShelf

should be: applicationWillEnterForeground, applicationDidBecomeActive (normal app resume process)

Wake up Apple TV with Kodi app as last open app

the second applicationWillResignActive followed by applicationDidBecomeActive looks strange. Are you sure there were no interruptions like some system dialog?

[sy6sy2]

I found this strange too :-/ I will try again just to be sure.

[sy6sy2]

I tried again and I can confirm the "strange" transition when you put the device to sleep while Kodi is running.

[sy6sy2]

This week I will try to have a look to this improvement. I think that I will try to do like Android --> https://github.com/xbmc/xbmc/pull/17187

[davilla]

Don't forget when tvos screensaver is up. You will get pushed into the background but tvOS will not schedule possible suspend in 5 seconds.