pip

PIPContainer

An easy to use interface for picture-in-picture on macOS 10.12 and later

Showing:

Popularity

Downloads/wk

0

GitHub Stars

110

Maintenance

Last Commit

3yrs ago

Contributors

2

Package

Dependencies

0

License

BSD

Categories

Readme

PIPContainer

Carthage compatible CocoaPods

An NSViewController subclass that can present its child view controller in picture-in-picture mode.

Please note that this project links against PIP.framework, which is private. Don't try to submit apps using this to the App Store.

demo

Integration

Carthage

Add the following line to your Cartfile and follow the integration instructions for Carthage:

github "insidegui/PIPContainer" ~> 1.0

CocoaPods

Add the following line to your Podfile and then run pod install:

pod 'PIPContainer'

Manually

Drag PIPContainer.xcodeproj to your project and add PIPContainer.framework to the Embedded Binaries section.

manual integration

Usage

Containment

The way it works is you add the view controller you want to display in the PiP as a child view controller of PIPContainerViewController. This can all be done using storyboards (see demos).

storyboard containment

Entering and Exiting PiP mode

After you have the correct containment setup, simply call togglePIP on PIPContainerViewController to enter/exit PiP mode.

private var pip: PIPContainerViewController? {
    return parent as? PIPContainerViewController
}
    
func togglePictureInPictureMode() {
    pip?.togglePIP(nil)
}

You can also link UI controls like buttons and menus directly to the togglePIP action in Interface Builder by control-dragging to the First Responder and selecting the action togglePIP:.

Getting notified about PiP commands

PIPContainerViewController has many block properties that you can use to get notifications about state changes.

  • pipDidPause: Called when the pause button is pressed in the PiP panel
  • pipDidPlay: Called when the play button is pressed in the PiP panel
  • pipWillOpen: Called when the PiP panel is about to be opened. This is the best moment to set the isPlaying property of PIPContainerViewController to reflect the state of your player
  • pipWillClose: Called when the PiP panel is about to be closed
  • pipDidClose: Called after the PiP panel is closed and the view controller is back to its original position

Demos

I encourage you to have a look at the demos to get a better understanding of how PIPContainer works:

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100