//
//  XXGLoadingView.h
//  XXGPlayKit
//
//  Created by apple on 2025/3/11.
//

#import <UIKit/UIKit.h>

NS_ASSUME_NONNULL_BEGIN

@interface XXGLoadingView : UIView

/// 开始加载动画并显示控件
- (void)startAnimating;
/// 停止加载动画并隐藏控件
- (void)stopAnimating;
/// 更新加载提示文字
- (void)setLoadingText:(NSString *)text;

#pragma mark - 类方法
/// 显示 Loading 控件到 keyWindow 上
+ (void)showLoadingOnWindow;
+ (void)showLoadingOnWindowWithText:(NSString *)text;
/// 从 keyWindow 上隐藏 Loading 控件
+ (void)hideLoadingFromWindow;

+ (XXGLoadingView *)showLoadingOnView:(UIView *)view;
/// 显示 Loading 控件到指定的视图上，并设置提示文字，返回创建的控件实例（方便外部后续更新文字）
+ (XXGLoadingView *)showLoadingOnView:(UIView *)view withText:(NSString *_Nullable)text;
/// 从指定的视图上隐藏 Loading 控件
+ (void)hideLoadingFromView:(UIView *)view;

@end

NS_ASSUME_NONNULL_END