Merge pull request #533 from CleverTap/SDK-5626-v7.6.0

[SDK-5626] Prepare v7.6.0

Author: nishant-clevertap

CHANGELOG.md

@@ -1,6 +1,13 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+### [Version 7.6.0](https://github.com/CleverTap/clevertap-ios-sdk/releases/tag/7.6.0) (April 17, 2026)
+#### Added
+- **Picture-in-Picture (PiP) In-App Notifications:** Introduces Picture-in-Picture in-app notifications — a compact, draggable floating overlay that persists over app content. Supports image, GIF, and video media with configurable controls.
+- **InApp Media Support:** Adds GIF and video playback support across all in-app notification templates, enabling richer media experiences within the app.
+- **App Inbox Default Media View:** Introduces a fallback media view for App Inbox entries that lack a specified media orientation, rendering images, GIFs, video posters, and audio thumbnails at their natural aspect ratio.
+- Adds support for backend-driven mute durations via the `X-WZRK-MUTE-DURATION` response header for more precise, server-controlled mute windows.
+
 ### [Version 7.5.1](https://github.com/CleverTap/clevertap-ios-sdk/releases/tag/7.5.1) (March 4, 2026)
 #### Added
 - Adds deep link URL capture in InApp notification click events, providing consistent attribution with Push notifications. Supports button-level deep links for CTA clicks and template-level deep links for image-only and HTML templates.

CleverTapSDK.xcodeproj/project.pbxproj

@@ -53,6 +53,7 @@ NS_ASSUME_NONNULL_BEGIN
 #endif
 
 - (BOOL)isMuted;
+- (void)unmute;
 - (BOOL)updateDomainFromResponseHeaders:(NSDictionary *)headers;
 - (BOOL)updateNotificationViewedDomainFromResponseHeaders:(NSDictionary *)headers;
 - (void)updateMutedFromResponseHeaders:(NSDictionary *)headers;

CleverTapSDK/CTDomainFactory.h

@@ -18,15 +18,16 @@
 NSString *const kREDIRECT_HEADER = @"X-WZRK-RD";
 NSString *const kREDIRECT_NOTIF_VIEWED_HEADER = @"X-WZRK-SPIKY-RD";
 NSString *const kMUTE_HEADER = @"X-WZRK-MUTE";
+NSString *const kMUTE_DURATION_HEADER = @"X-WZRK-MUTE-DURATION";
 
-NSString *const kMUTED_TS_KEY = @"CLTAP_MUTED_TS_KEY";
+NSString *const kMUTE_EXPIRY_TS_KEY = @"CLTAP_MUTE_EXPIRY_TS_KEY";
 NSTimeInterval const kMUTE_SECONDS = 24 * 60 * 60;
 
 @interface CTDomainFactory ()
 @property (nonatomic, strong) CleverTapInstanceConfig *config;
 @property (nonatomic, strong) CTRequestSender *requestSender;
 
-@property (nonatomic, assign) NSTimeInterval lastMutedTs;
+@property (nonatomic, assign) NSTimeInterval muteExpiryTs;
 
 #if CLEVERTAP_SSL_PINNING
 @property(nonatomic, strong) CTPinnedNSURLSessionDelegate *urlSessionDelegate;
@@ -71,22 +72,23 @@ - (void)setRequestSender:(CTRequestSender *)requestSender {
 
 - (void)loadMutedTs {
     if (self.config.isDefaultInstance) {
-        self.lastMutedTs = [CTPreferences getIntForKey:[CTPreferences storageKeyWithSuffix:kMUTED_TS_KEY config: self.config] withResetValue:[CTPreferences getIntForKey:kMUTED_TS_KEY withResetValue:0]];
+        self.muteExpiryTs = [CTPreferences getIntForKey:[CTPreferences storageKeyWithSuffix:kMUTE_EXPIRY_TS_KEY config: self.config] withResetValue:[CTPreferences getIntForKey:kMUTE_EXPIRY_TS_KEY withResetValue:0]];
     } else {
-        self.lastMutedTs = [CTPreferences getIntForKey:[CTPreferences storageKeyWithSuffix:kMUTED_TS_KEY config: self.config] withResetValue:0];
+        self.muteExpiryTs = [CTPreferences getIntForKey:[CTPreferences storageKeyWithSuffix:kMUTE_EXPIRY_TS_KEY config: self.config] withResetValue:0];
     }
 }
 
 - (BOOL)isMuted {
-    return [NSDate new].timeIntervalSince1970 - self.lastMutedTs < kMUTE_SECONDS;
+    return [NSDate new].timeIntervalSince1970 < self.muteExpiryTs;
 }
 
 - (void)clearRedirectDomain {
     self.redirectDomain = nil;
     self.redirectNotifViewedDomain = nil;
     [self persistRedirectDomain]; // if nil persist will remove
+    [self persistRedirectNotifViewedDomain]; // if nil persist will remove
     self.redirectDomain = [self loadRedirectDomain]; // reload explicit domain if we have one else will be nil
-    self.redirectNotifViewedDomain = [self loadRedirectNotifViewedDomain]; // reload explicit notification viewe domain if we have one else will be nil
+    self.redirectNotifViewedDomain = [self loadRedirectNotifViewedDomain]; // reload explicit notification viewed domain if we have one else will be nil
 }
 
 - (NSString *)loadRedirectDomain {
@@ -167,8 +169,19 @@ - (void)persistRedirectNotifViewedDomain {
 }
 
 - (void)persistMutedTs {
-    self.lastMutedTs = [NSDate new].timeIntervalSince1970;
-    [CTPreferences putInt:self.lastMutedTs forKey:[CTPreferences storageKeyWithSuffix:kMUTED_TS_KEY config: self.config]];
+    NSTimeInterval expiryTs = [NSDate new].timeIntervalSince1970 + kMUTE_SECONDS;
+    self.muteExpiryTs = expiryTs;
+    [CTPreferences putInt:self.muteExpiryTs forKey:[CTPreferences storageKeyWithSuffix:kMUTE_EXPIRY_TS_KEY config: self.config]];
+}
+
+- (void)persistMutedExpiry:(NSTimeInterval)expiryTs {
+    self.muteExpiryTs = expiryTs;
+    [CTPreferences putInt:self.muteExpiryTs forKey:[CTPreferences storageKeyWithSuffix:kMUTE_EXPIRY_TS_KEY config: self.config]];
+}
+
+- (void)unmute {
+    self.muteExpiryTs = 0;
+    [CTPreferences putInt:0 forKey:[CTPreferences storageKeyWithSuffix:kMUTE_EXPIRY_TS_KEY config:self.config]];
 }
 
 #pragma mark - Handshake Handling
@@ -244,7 +257,13 @@ - (void)updateMutedFromResponseHeaders:(NSDictionary *)headers {
     NSString *mutedString = headers[kMUTE_HEADER];
     BOOL muted = (mutedString == nil ? NO : [mutedString boolValue]);
     if (muted) {
-        [self persistMutedTs];
+        NSString *muteDurationString = headers[kMUTE_DURATION_HEADER];
+        if (muteDurationString != nil) {
+            long long muteExpiryMs = [muteDurationString longLongValue];
+            [self persistMutedExpiry:muteExpiryMs / 1000.0];
+        } else {
+            [self persistMutedTs];
+        }
         if (self.domainResolverDelegate && [self.domainResolverDelegate respondsToSelector:@selector(onMute)]) {
             [self.domainResolverDelegate onMute];
         }

CleverTapSDK/CTDomainFactory.m

@@ -37,6 +37,7 @@
 @property (nonatomic, strong, readonly) NSURL *imageUrlLandscape;
 @property (nonatomic, copy, readonly) NSString *contentType;
 @property (nonatomic, copy, readonly) NSString *mediaUrl;
+@property (nonatomic, copy, readonly) NSString *mediaUrlLandscape;
 @property (nonatomic, readonly, assign) BOOL mediaIsVideo;
 @property (nonatomic, readonly, assign) BOOL mediaIsAudio;
 @property (nonatomic, readonly, assign) BOOL mediaIsImage;
@@ -57,6 +58,7 @@
 
 @property (nonatomic, copy, readonly) NSDictionary *jsonDescription;
 @property (nonatomic) NSString *error;
+@property (nonatomic) NSString *errorLandscape;
 
 @property (nonatomic, copy, readonly) NSDictionary *customExtras;
 @property (nonatomic, copy, readwrite) NSDictionary *actionExtras;

CleverTapSDK/CTInAppNotification.h

@@ -24,6 +24,7 @@ @interface CTInAppNotification() {
 @property (nonatomic, copy, readwrite) NSString *contentType;
 @property (nonatomic, copy, readwrite) NSString *landscapeContentType;
 @property (nonatomic, copy, readwrite) NSString *mediaUrl;
+@property (nonatomic, copy, readwrite) NSString *mediaUrlLandscape;
 @property (nonatomic, copy, readwrite) NSString *contentDescription;
 @property (nonatomic, copy, readwrite) NSString *landscapeContentDescription;
 
@@ -172,6 +173,8 @@ - (void)configureFromJSON: (NSDictionary *)jsonObject {
                 if (![self.landscapeContentType isEqualToString:@"image/gif"] ) {
                     _mediaIsImage = YES;
                 }
+            } else if ([self.landscapeContentType hasPrefix:@"video"]) {
+                self.mediaUrlLandscape = _mediaUrlLandscape;
             }
         }
     }
@@ -203,21 +206,24 @@ - (void)configureFromJSON: (NSDictionary *)jsonObject {
     switch (self.inAppType) {
         case CTInAppTypeHeader:
         case CTInAppTypeFooter:
-            if  (_mediaIsGif || _mediaIsAudio || _mediaIsVideo){
+            // GIF support added, video and audio not supported
+            if  (_mediaIsAudio || _mediaIsVideo){
                 self.imageURL = nil;
                 CleverTapLogStaticDebug(@"unable to download media, wrong media type for template");
             }
             break;
         case CTInAppTypeCoverImage:
         case CTInAppTypeInterstitialImage:
         case CTInAppTypeHalfInterstitialImage:
-            if  (_mediaIsGif || _mediaIsAudio || _mediaIsVideo || !_mediaIsImage){
+            // GIF and Video support added for image-only templates
+            if  (_mediaIsAudio){
                 self.error = [NSString stringWithFormat:@"wrong media type for template"];
             }
             break;
         case CTInAppTypeCover:
         case CTInAppTypeHalfInterstitial:
-            if  (_mediaIsGif || _mediaIsAudio || _mediaIsVideo){
+            // GIF support added, video and audio not supported
+            if  (_mediaIsAudio || _mediaIsVideo){
                 self.imageURL = nil;
                 CleverTapLogStaticDebug(@"unable to download media, wrong media type for template");
             }
@@ -293,7 +299,7 @@ - (void)setPreparedInAppImage:(UIImage *)inAppImage
 
 - (void)setPreparedInAppImageLandscape:(UIImage *)inAppImageLandscape
                inAppImageLandscapeData:(NSData *)inAppImageLandscapeData error:(NSString *)error {
-    self.error = error;
+    self.errorLandscape = error;
     self.inAppImageLandscape = inAppImageLandscape;
     self.imageLandscapeData = inAppImageLandscapeData;
 }

CleverTapSDK/CTInAppNotification.m

@@ -13,7 +13,8 @@ typedef NS_ENUM(NSUInteger, CTInAppType){
     CTInAppTypeInterstitialImage,
     CTInAppTypeHalfInterstitialImage,
     CTInAppTypeCoverImage,
-    CTInAppTypeCustom
+    CTInAppTypeCustom,
+    CTInAppTypePiP
 };
 
 typedef NS_ENUM(NSUInteger, CTInAppActionType){

CleverTapSDK/CTInAppUtils.h

@@ -26,7 +26,8 @@ @implementation CTInAppUtils
             @"interstitial-image": @(CTInAppTypeInterstitialImage),
             @"half-interstitial-image": @(CTInAppTypeHalfInterstitialImage),
             @"cover-image": @(CTInAppTypeCoverImage),
-            @"custom-code": @(CTInAppTypeCustom)
+            @"custom-code": @(CTInAppTypeCustom),
+            @"pip": @(CTInAppTypePiP)
         };
     }
     return _inAppTypeMap;

CleverTapSDK/CTInAppUtils.m

@@ -70,19 +70,21 @@ + (BOOL)isUserInterfaceIdiomPad {
 
 #if !(TARGET_OS_TV)
 + (BOOL)isDeviceOrientationLandscape {
-    UIInterfaceOrientation orientation;
-    if (@available(iOS 15.0, *)) {
-        orientation = [CTUIUtils getSharedApplication].windows.firstObject.windowScene.interfaceOrientation;
-    } else if (@available(iOS 13.0, *)) {
-        orientation = [CTUIUtils getSharedApplication].windows.firstObject.windowScene.interfaceOrientation;
-    } else {
+    if (@available(iOS 13.0, *)) {
+        UIInterfaceOrientation orientation = UIInterfaceOrientationPortrait;
+        NSSet *connectedScenes = [CTUIUtils getSharedApplication].connectedScenes;
+        for (UIScene *scene in connectedScenes) {
+            if (scene.activationState == UISceneActivationStateForegroundActive && [scene isKindOfClass:[UIWindowScene class]]) {
+                orientation = ((UIWindowScene *)scene).interfaceOrientation;
+                break;
+            }
+        }
+        return UIInterfaceOrientationIsLandscape(orientation);
+    }
 #pragma clang diagnostic push
 #pragma clang diagnostic ignored "-Wdeprecated-declarations"
-        orientation = [[CTUIUtils getSharedApplication] statusBarOrientation];
+    return UIInterfaceOrientationIsLandscape([[CTUIUtils getSharedApplication] statusBarOrientation]);
 #pragma clang diagnostic pop
-    }
-    BOOL landscape = UIInterfaceOrientationIsLandscape(orientation);
-    return landscape;
 }
 #endif
 

CleverTapSDK/CTUIUtils.m

@@ -1446,7 +1446,21 @@ extern NSString * _Nonnull const CleverTapProfileDidInitializeNotification;
 
 /*!
  @method
- 
+
+ @abstract
+ Clears any active mute state set by the backend, allowing the SDK to resume
+ normal event tracking and network operations immediately.
+
+ @discussion
+ The CleverTap backend can mute a client for a set duration (e.g., during a
+ detected abuse scenario). Call this method to override that mute and restore
+ normal SDK operation without waiting for the mute period to expire.
+ */
+- (void)unmute;
+
+/*!
+ @method
+
  @abstract
  Checks if a custom CleverTapID is valid
  */