[TIL] YouTube iOSPlayerHelper

YouTube iOSPlayerHelper는 YouTube 동영상을 iOS 앱에서 쉽게 재생할 수 있도록 지원하는 라이브러리입니다.
Google에서 제공하며, YouTube 동영상 임베딩과 컨트롤 기능을 구현할 수 있습니다.

---

1. YouTube iOSPlayerHelper란?

• YouTube 영상 재생을 위한 iOS SDK
• UIWebView 기반에서 시작했으나 현재는 WKWebView 사용
• 앱에서 YouTube Player API를 쉽게 사용할 수 있도록 도와줌
• Swift와 Objective-C 모두 지원

---

2. 주요 특징

• YouTube 동영상 재생 기능 제공
• 재생, 일시정지, 탐색 등 기본 컨트롤 가능
• 동영상 이벤트 콜백 지원 (재생 시작, 종료 등)
• API 키를 통한 인증 필요 없음

---

3. 설치 방법

CocoaPods

Podfile에 다음을 추가:

pod 'youtube-ios-player-helper'

터미널에서:

pod install

---

4. 기본 사용법

4.1 뷰에 Player 추가

import youtube_ios_player_helper

class ViewController: UIViewController {

    @IBOutlet weak var playerView: YTPlayerView!

    override func viewDidLoad() {
        super.viewDidLoad()
        playerView.load(withVideoId: "VIDEO_ID")
    }
}

---

5. 주요 메서드

• load(withVideoId:) : 특정 YouTube 영상 로드
• playVideo() : 재생
• pauseVideo() : 일시 정지
• stopVideo() : 정지
• seek(toSeconds:suggestedQuality:) : 특정 시간으로 이동

---

6. 이벤트 처리

YTPlayerViewDelegate를 사용하여 이벤트를 감지할 수 있습니다.

extension ViewController: YTPlayerViewDelegate {
    func playerViewDidBecomeReady(_ playerView: YTPlayerView) {
        print("Player is ready")
        playerView.playVideo()
    }

    func playerView(_ playerView: YTPlayerView, didChangeTo state: YTPlayerState) {
        print("State changed: \(state)")
    }
}

---

7. 장점

• 구현이 간단하고 YouTube API 직접 호출 필요 없음
• 재생 UI를 쉽게 추가 가능
• Swift/Objective-C 호환

---

8. 단점

• 커스터마이징 제한 (YouTube 정책 때문)
• 네트워크 의존도가 높음
• iOS 외 플랫폼 호환성 없음

---

결론

YouTube iOSPlayerHelper는 iOS 앱에서 YouTube 동영상을 재생하는 가장 간단한 방법 중 하나입니다.
복잡한 API 구현 없이, 몇 줄의 코드로 YouTube 플레이어 기능을 사용할 수 있습니다.