cemck / Photon-API

Photon API

Beginning with version 1.0.7, Photon offers an API allowing third-party tweaks to listen for Photon Ambient Display state changes. Please make sure to use all 3 notifications.

Header.h

@interface PhotonAPI : NSObject
+ (BOOL)isShowing;
+ (BOOL)isInPocket;
@end

Tweak.x(m)

#import <notify.h> // Make sure to include the 'notification' header

- (void)yourInitMethod {
  ...
  
  // 1. Register for 'Show Photon' notification
  int notify_token;
  notify_register_dispatch("com.cemck.photon/startAmbientDisplay", &notify_token, dispatch_get_main_queue(), ^(int token) {
      // Set your values animated
      [UIView animateWithDuration:0.9 delay:0 options:UIViewAnimationOptionCurveEaseInOut animations:^{
          self.view.alpha = 0; // Show/Hide your view
      } completion:nil];
  });
  
  // 2. Register for 'Show Photon without animation' notification
  int notify_token2;
  notify_register_dispatch("com.cemck.photon/startAmbientDisplay.noAnimation", &notify_token2, dispatch_get_main_queue(), ^(int token) {
      // Set your values
      self.view.alpha = 1; // Show/Hide your view
  });
  
  // 3. Register for 'Hide Photon' notification
  int notify_token3;
  notify_register_dispatch("com.cemck.photon/stopAmbientDisplay", &notify_token3, dispatch_get_main_queue(), ^(int token) {
      // Set your values animated
      [UIView animateWithDuration:0.9 delay:0 options:UIViewAnimationOptionCurveEaseInOut animations:^{
          self.view.alpha = 1; // Show/Hide your view
      } completion:nil];
  });
}

- (void)yourAlternativeMethod {
  ...
  
  BOOL photonIsShowing = [%c(PhotonAPI) isShowing]; // Get the Ambient Display state
  
  if (photonIsShowing) {
    // Do stuff (Ambient Display is active)
  } else {
    // Do stuff (Ambient Display is hidden)
  }
}