Live Stream List (iOS)

// Example: YourLiveListViewController is the view controller representing your live stream list waterfall layout
class YourLiveListViewController: UIViewController {

    // 1. Declare liveListView as a member variable
    //        - style: .doubleColumn // Two-column waterfall layout
    //        - style: .singleColumn // Single-column waterfall layout
    // Example shows a two-column waterfall layout, if needed input .singleColumn just
    private let liveListView = LiveListView(style: .doubleColumn) 

    public override func viewDidLoad() {
        super.viewDidLoad()
        // 2. Add liveListView to view
        view.addSubview(liveListView)
        liveListView.snp.makeConstraints { make in
            make.edges.equalToSuperview()
        }
        // 3. Set the click event delegate for the list
        liveListView.itemClickDelegate = self
    }
}

// Implement OnItemClickDelegate in your live stream list view controller, for example: YourLiveListViewController
extension YourLiveListViewController: OnItemClickDelegate {

    func onItemClick(liveInfo: LiveInfo, frame: CGRect) {
        // 1. Instantiate your audience view controller
        let audienceVC = YourAudienceViewController(roomId: liveInfo.roomId)
        audienceVC.modalPresentationStyle = .fullScreen
        // 2. Navigate to your audience view controller
        present(audienceVC, animated: false)
    }
    
}

// Implement in your live stream list view controller, for example: YourLiveListViewController
class YourLiveListViewController: UIViewController {

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        // refreshLiveList: Call this method in viewDidAppear to ensure getting the latest list every time returning to current page
        liveListView.refreshLiveList()
    }

    override func viewWillDisappear(_ animated: Bool) {
        super.viewWillDisappear(animated)
        // onRouteToNextPage: Call this method in viewWillDisappear to stop the video stream playback on current live list page when entering another page
        liveListView.onRouteToNextPage()
    }
}

// Example: YourLiveListViewController is the view controller representing your live stream list waterfall layout
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. Set custom data source agent
        liveListView.dataSource = self
    }
}

// 2. Implement custom data source agent: LiveListDataSource
extension YourLiveListViewController: LiveListDataSource {

    public func fetchLiveList(cursor: String, onSuccess: @escaping LiveListBlock, onError: @escaping TUIErrorBlock) {
        // 3. Connect to your own backend business and return data to the UI component in the following format
        var liveInfoList: [LiveInfo] = []
        var liveInfo = LiveInfo()
        liveInfo.roomId = "live_123456"
        liveInfo.name = "live_123456"
        liveInfoList.append(liveInfo)
        let cursor = "aabbccdd"
        onSuccess(cursor, liveInfoList)
    }
}

// Example: YourLiveListViewController is the view controller representing your live stream list waterfall layout
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. Set adapter
        liveListView.adapter = self
    }
}

// 2. Implement custom widget agent
extension YourLiveListViewController: LiveListViewAdapter {
    public func createLiveInfoView(info: LiveInfo) -> UIView {
        // Custom view
        return YourCustomView(liveInfo: info)
    }
    
    public func updateLiveInfoView(view: UIView, info: LiveInfo) {
        if let infoView = view as? YourCustomView {
            // Custom view update data
            infoView.updateView(liveInfo: info)
        } 
    }
}

// Implement OnItemClickDelegate in your live stream waterfall layout list view controller, for example: YourLiveListViewController
extension YourLiveListViewController: OnItemClickDelegate {

    func onItemClick(liveInfo: LiveInfo, frame: CGRect) {
        let audienceVC = YourAudienceViewController(roomId: liveInfo.roomId)
        audienceVC.modalPresentationStyle = .fullScreen
        // Set the transition animation delegate
        audienceVC.transitioningDelegate = LiveTransitioningDelegate(originFrame: frame)
        present(audienceVC, animated: false)
    }
    
}