mirror of
https://github.com/firebase/firebase-ios-sdk
synced 2026-11-09 22:36:01 +05:45
95 lines
3.3 KiB
Objective-C
95 lines
3.3 KiB
Objective-C
/*
|
|
* Copyright 2018 Google
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
#import <GoogleDataTransport/GDTCOREventDataObject.h>
|
|
|
|
@class GDTCORClock;
|
|
@class GDTCORDataFuture;
|
|
@class GDTCORStoredEvent;
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/** The different possible quality of service specifiers. High values indicate high priority. */
|
|
typedef NS_ENUM(NSInteger, GDTCOREventQoS) {
|
|
/** The QoS tier wasn't set, and won't ever be sent. */
|
|
GDTCOREventQoSUnknown = 0,
|
|
|
|
/** This event is internal telemetry data that should not be sent on its own if possible. */
|
|
GDTCOREventQoSTelemetry = 1,
|
|
|
|
/** This event should be sent, but in a batch only roughly once per day. */
|
|
GDTCOREventQoSDaily = 2,
|
|
|
|
/** This event should be sent when requested by the uploader. */
|
|
GDTCOREventQosDefault = 3,
|
|
|
|
/** This event should be sent immediately along with any other data that can be batched. */
|
|
GDTCOREventQoSFast = 4,
|
|
|
|
/** This event should only be uploaded on wifi. */
|
|
GDTCOREventQoSWifiOnly = 5,
|
|
};
|
|
|
|
@interface GDTCOREvent : NSObject <NSSecureCoding>
|
|
|
|
/** The mapping identifier, to allow backends to map the transport bytes to a proto. */
|
|
@property(readonly, nonatomic) NSString *mappingID;
|
|
|
|
/** The identifier for the backend this event will eventually be sent to. */
|
|
@property(readonly, nonatomic) NSInteger target;
|
|
|
|
/** The data object encapsulated in the transport of your choice, as long as it implements
|
|
* the GDTCOREventDataObject protocol. */
|
|
@property(nullable, nonatomic) id<GDTCOREventDataObject> dataObject;
|
|
|
|
/** The quality of service tier this event belongs to. */
|
|
@property(nonatomic) GDTCOREventQoS qosTier;
|
|
|
|
/** The clock snapshot at the time of the event. */
|
|
@property(nonatomic) GDTCORClock *clockSnapshot;
|
|
|
|
/** A dictionary provided to aid prioritizers by allowing the passing of arbitrary data. It will be
|
|
* retained by a copy in -copy, but not used for -hash.
|
|
*
|
|
* @note Ensure that classes contained therein implement NSSecureCoding to prevent loss of data.
|
|
*/
|
|
@property(nullable, nonatomic) NSDictionary *customPrioritizationParams;
|
|
|
|
// Please use the designated initializer.
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
|
|
/** Initializes an instance using the given mappingID.
|
|
*
|
|
* @param mappingID The mapping identifier.
|
|
* @param target The event's target identifier.
|
|
* @return An instance of this class.
|
|
*/
|
|
- (nullable instancetype)initWithMappingID:(NSString *)mappingID
|
|
target:(NSInteger)target NS_DESIGNATED_INITIALIZER;
|
|
|
|
/** Returns the GDTCORStoredEvent equivalent of self.
|
|
*
|
|
* @param dataFuture The data future representing the transport bytes of the original event.
|
|
* @return An equivalent GDTCORStoredEvent.
|
|
*/
|
|
- (GDTCORStoredEvent *)storedEventWithDataFuture:(GDTCORDataFuture *)dataFuture;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|