Mark Notification Tray Seen

Global Tray Tracking

Update the tray’s seen timestamp on server when user visits the Notification Tray screen

Badge Management

Control UI badge indicators based on global seen status

Overview

Use markNotificationTraySeen() to update the tray’s seen timestamp on the server when the user visits the Notification Tray screen. This method supports global-level read tracking, separate from per-item seen state. Once invoked, future calls to getNotificationTraySeen() will return the new isSeen value. It is recommended to call this method as soon as the tray UI is opened.

This method updates the global tray seen state, not individual notification items. Use markSeen() on individual items for fine-grained tracking.

Implementation Guide

import AmitySDK

class NotificationTrayViewController: UIViewController {
    private let repository = AmityNotificationTrayRepository()
    
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        
        // Mark tray as seen when user opens it
        markTrayAsSeen()
    }
    
    private func markTrayAsSeen() {
        repository.markNotificationTraySeen { [weak self] result in
            DispatchQueue.main.async {
                switch result {
                case .success:
                    self?.updateGlobalBadgeState()
                case .failure(let error):
                    print("Failed to mark tray as seen: \(error)")
                }
            }
        }
    }
    
    private func updateGlobalBadgeState() {
        // Update global app badge
        NotificationCenter.default.post(
            name: .notificationTrayMarkedAsSeen,
            object: nil
        )
    }
}

Usage Patterns

🎯 When to Mark Tray as Seen

Screen Visibility

Primary Triggers

User opens/navigates to notification tray screen
Tray becomes visible in UI (viewDidAppear, onResume)
User focuses on notification tray tab/section

User Intent

Secondary Triggers

User pulls-to-refresh in tray
User explicitly marks “all as read”
User interacts with tray controls

Implementation Timing Examples

// Option 1: Mark when view appears (recommended)
override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    markTrayAsSeen()
}

// Option 2: Mark with slight delay for better UX
override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
        self.markTrayAsSeen()
    }
}

// Option 3: Mark when user scrolls (indicating engagement)
func scrollViewDidScroll(_ scrollView: UIScrollView) {
    if !hasMarkedAsSeen && scrollView.contentOffset.y > 50 {
        hasMarkedAsSeen = true
        markTrayAsSeen()
    }
}

🔄 State Synchronization Patterns

🎨 UI State Management

Before and After Visual States

/* Notification indicators showing unseen state */
.notification-badge {
    display: inline-block;
    background-color: #ef4444;
    color: white;
    border-radius: 50%;
    width: 8px;
    height: 8px;
}

.tab-item.has-notifications::after {
    content: '';
    position: absolute;
    top: 4px;
    right: 4px;
    width: 6px;
    height: 6px;
    background-color: #ef4444;
    border-radius: 50%;
}

Error Handling

Common Error Scenarios

Error Handling Implementation

class NotificationTrayErrorHandler {
    private let repository = AmityNotificationTrayRepository()
    private var retryAttempts = 0
    private let maxRetryAttempts = 3
    
    func markTraySeenWithErrorHandling(completion: @escaping (Bool) -> Void) {
        repository.markNotificationTraySeen { [weak self] result in
            DispatchQueue.main.async {
                switch result {
                case .success:
                    self?.retryAttempts = 0
                    completion(true)
                    
                case .failure(let error):
                    self?.handleMarkSeenError(error, completion: completion)
                }
            }
        }
    }
    
    private func handleMarkSeenError(_ error: Error, completion: @escaping (Bool) -> Void) {
        retryAttempts += 1
        
        if let amityError = error as? AmityError {
            switch amityError.code {
            case .networkError:
                if retryAttempts < maxRetryAttempts {
                    // Exponential backoff retry
                    let delay = pow(2.0, Double(retryAttempts))
                    DispatchQueue.main.asyncAfter(deadline: .now() + delay) { [weak self] in
                        self?.markTraySeenWithErrorHandling(completion: completion)
                    }
                } else {
                    // Fail silently but log error - don't block UI
                    print("Failed to mark tray as seen after \(maxRetryAttempts) attempts")
                    completion(false)
                }
                
            case .permissionDenied:
                // Handle authentication issues
                handleAuthenticationError()
                completion(false)
                
            default:
                // For other errors, fail silently
                print("Error marking tray as seen: \(error)")
                completion(false)
            }
        }
    }
    
    private func handleAuthenticationError() {
        // Trigger re-authentication flow
        NotificationCenter.default.post(name: .authenticationRequired, object: nil)
    }
}

Best Practices

🎯 Implementation Guidelines

🔧 Performance Optimization

🎨 User Experience

🔒 Security Considerations

Get Tray Seen Status

Check current global notification tray seen status

Mark Individual Items

Track seen status for specific notification items

Query Tray Items

Retrieve and filter notification tray items

Powered by

Getting Started

Fundamentals

Social

Chat

Video

Support

Mark notification tray seen

Mark Notification Tray Seen

Global Tray Tracking

Badge Management

Overview

Implementation Guide

Usage Patterns

Screen Visibility

User Intent

Implementation Timing Examples

Global Badge Management Flow

Cross-screen Badge Updates

Tab Bar Badges

App Icon Badge

Header Indicators

Menu Badges

Before and After Visual States

Error Handling

Network Connectivity

Concurrent Operations

Authentication Issues

State Inconsistency

Best Practices

Timing

Error Handling

Get Tray Seen Status

Mark Individual Items

Query Tray Items

Powered by

Getting Started

Fundamentals

Social

Chat

Video

Support

​Mark Notification Tray Seen

Global Tray Tracking

Badge Management

​Overview

​Implementation Guide

​Usage Patterns

​Error Handling

​Best Practices

​Related Documentation

Get Tray Seen Status

Mark Individual Items

Query Tray Items

Mark Notification Tray Seen

Overview

Implementation Guide

Usage Patterns

Error Handling

Best Practices

Related Documentation