// 示例： YourLiveListViewController 代表您直播列表瀑布流的视图控制器
class YourLiveListViewController: UIViewController {

    // 1.  声明 liveListView 作为成员变量
    //        - style: .doubleColumn // 双列瀑布流
    //        - style: .singleColumn // 单列瀑布流
    // 示例为双列瀑布流，如需单列传入 .singleColumn即可
    private let liveListView = LiveListView(style: .doubleColumn) 

    public override func viewDidLoad() {
        super.viewDidLoad()
        // 2. 将 liveListView 添加到视图上
        view.addSubview(liveListView)
        liveListView.snp.makeConstraints { make in
            make.edges.equalToSuperview()
        }
        // 3. 设置列表的点击事件代理
        liveListView.itemClickDelegate = self
    }
}

// 在您的直播瀑布流列表视图控制器中实现 OnItemClickDelegate, 示例：YourLiveListViewController
extension YourLiveListViewController: OnItemClickDelegate {

    func onItemClick(liveInfo: LiveInfo, frame: CGRect) {
        // 1. 实例化您的观众观看视图控制器
        let audienceVC = YourAudienceViewController(roomId: liveInfo.roomId)
        audienceVC.modalPresentationStyle = .fullScreen
        // 2. 跳转到您的观众观看视图控制器
        present(audienceVC, animated: false)
    }
    
}

// 在您的直播瀑布流列表视图控制器中实现，示例：YourLiveListViewController
class YourLiveListViewController: UIViewController {

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        // refreshLiveList: 在viewDidAppear时调用此方法，以确保每次回到当前页面都能拿到最新的列表
        liveListView.refreshLiveList()
    }

    override func viewWillDisappear(_ animated: Bool) {
        super.viewWillDisappear(animated)
        // onRouteToNextPage: 在viewWillDisappear时调用此方法，当您进入别的页面时停止当前直播列表页播放的视频流
        liveListView.onRouteToNextPage()
    }
}

// 示例：YourLiveListViewController 代表您直播列表瀑布流的视图控制器
class YourLiveListViewController: UIViewController {

    private let liveListView: LiveListView = LiveListView(style: .doubleColumn) 

    public override func viewDidLoad() {
        super.viewDidLoad()
        view.addSubview(liveListView)
        liveListView.snp.makeConstraints { make in
            make.edges.equalToSuperview()
        }
        liveListView.itemClickDelegate = self
        // 1. 设置自定义数据源代理
        liveListView.dataSource = self
    }
}

// 2. 实现自定义数据源代理: LiveListDataSource
extension YourLiveListViewController: LiveListDataSource {

    public func fetchLiveList(cursor: String, onSuccess: @escaping LiveListBlock, onError: @escaping TUIErrorBlock) {
        // 3. 对接自己的业务后台，按照下面的格式返回数据给UI组件
        var liveInfoList: [LiveInfo] = []
        var liveInfo = LiveInfo()
        liveInfo.roomId = "live_123456"
        liveInfo.name = "live_123456"
        liveInfoList.append(liveInfo)
        let cursor = "aabbccdd"
        onSuccess(cursor, liveInfoList)
    }
}

// 示例：YourLiveListViewController 代表您直播列表瀑布流的视图控制器
class YourLiveListViewController: UIViewController {

    private let liveListView: LiveListView = LiveListView(style: .doubleColumn) 

    public override func viewDidLoad() {
        super.viewDidLoad()
        view.addSubview(liveListView)
        liveListView.snp.makeConstraints { make in
            make.edges.equalToSuperview()
        }
        liveListView.itemClickDelegate = self
        liveListView.dataSource = self
        // 1. 设置自定义挂件代理
        liveListView.adapter = self
    }
}

// 2. 实现自定义挂件代理
extension YourLiveListViewController: LiveListViewAdapter {
    public func createLiveInfoView(info: LiveInfo) -> UIView {
        // 自定义挂件view
        return YourCustomView(liveInfo: info)
    }
    
    public func updateLiveInfoView(view: UIView, info: LiveInfo) {
        if let infoView = view as? YourCustomView {
            // 更新挂件view中绑定的数据
            infoView.updateView(liveInfo: info)
        } 
    }
}

// 在您的直播瀑布流列表视图控制器中的 OnItemClickDelegate 回调中, 示例：YourLiveListViewController
extension YourLiveListViewController: OnItemClickDelegate {

    func onItemClick(liveInfo: LiveInfo, frame: CGRect) {
        let audienceVC = YourAudienceViewController(roomId: liveInfo.roomId)
        audienceVC.modalPresentationStyle = .fullScreen
        // 设置过渡动画代理
        audienceVC.transitioningDelegate = LiveTransitioningDelegate(originFrame: frame)
        present(audienceVC, animated: false)
    }
    
}