//
//  AMapNaviLogger.h
//  AMapNaviKit
//
//  Created by lihui.qlh on 2025/8/19.
//

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

/**
 * 日志级别
 */
typedef NS_ENUM(NSInteger, AMapNaviLogLevel) {
    AMapNaviLogLevelDebug = 0,
    AMapNaviLogLevelInfo = 1,
    AMapNaviLogLevelWarning = 2,
    AMapNaviLogLevelError = 3,
    AMapNaviLogLevelFatal = 4,
    AMapNaviLogLevelTrack = 5 // 用于排查性能问题
};

@protocol AMapNaviLoggerProtocol <NSObject>

- (void)onNaviLog:(AMapNaviLogLevel)logLevel logContent:(nonnull NSString *)logContent;

@end

@interface AMapNaviLogger : NSObject

+ (instancetype)shareInstance;

/**
 * 设置日志代理，用于获取 SDK 内部日志，重复设置会覆盖
 */
- (void)setLogDelegate:(id<AMapNaviLoggerProtocol>)delegate;

- (void)onNaviLog:(AMapNaviLogLevel)logLevel logContent:(NSString *)logContent, ... NS_FORMAT_FUNCTION(2,3);

#pragma mark - FullLinkLog

/// 设置全链路日志回调(全局单例，只需要设置1次，不要重复设置，重复设置会覆盖)   Set full-link log callback.
/// 建议放在全局类中调用，如Appdelegate中
+ (void)setFullLinkLogBlock:(AMapNaviFullLinkLogBlock _Nonnull)block;

/// 清除全链路日志回调（全局单例，若不用需调用此方法) Clear the full-link log callback. (global singleton, call this method if not needed).
+ (void)clearFullLinkLogBlock;

@end

NS_ASSUME_NONNULL_END