AVPlayerViewController: এটি কী, iOS-এ ইন্টিগ্রেশন পদ্ধতি

AVPlayerViewController কী?

AVPlayerViewController হল AVKit ফ্রেমওয়ার্কের একটি উপাদান যা Apple অ্যাপ্লিকেশনে ভিডিও চালানোর জন্য একটি প্রস্তুত ইন্টারফেস প্রদান করে। এটি ডেভেলপারকে স্ক্র্যাচ থেকে কাস্টম প্লেয়ার তৈরি করার প্রয়োজন থেকে মুক্তি দেয়, মানক নিয়ন্ত্রণ প্রদান করে: প্লে/পজ, স্ক্রাবিং, ভলিউম সমন্বয় এবং পূর্ণ-স্ক্রীন মোড।

নিম্ন-স্তরের AVPlayerLayer-এর বিপরীতে, যার জন্য ম্যানুয়াল UI নির্মাণ প্রয়োজন, AVPlayerViewController সম্পূর্ণরূপে প্লেয়ার লাইফসাইকেল পরিচালনা করে। কন্ট্রোলার স্বয়ংক্রিয়ভাবে স্ক্রিন রোটেশন হ্যান্ডেল করে, নচযুক্ত iPhone-এ সেফ এরিয়ার সাথে খাপ খায় এবং iPad-এ মাল্টিটাস্কিং সমর্থন করে।

Apple ডকুমেন্টেশন (2026) অনুসারে, AVPlayerViewController AVPlayer এবং AVQueuePlayer-এর সাথে সামঞ্জস্যপূর্ণ, যা একক ফাইল এবং প্লেলিস্ট উভয়ই চালানোর অনুমতি দেয়। লোকাল স্টোরেজ থেকে URL, HLS নেটওয়ার্ক স্ট্রিম এবং এনক্রিপ্টেড FairPlay কন্টেন্ট সমর্থিত।

AVPlayerViewController-এর ইতিহাস এবং সংস্করণ

উপাদানটি iOS 8-এ AVKit-এর সাথে পুরাতন MPMoviePlayerController-এর প্রতিস্থাপন হিসাবে আবির্ভূত হয়েছিল। iOS 11-এ Picture in Picture এবং সাবটাইটেল প্রদর্শনের জন্য সমর্থন যুক্ত করা হয়েছিল। iOS 14-এ, কন্ট্রোলার AVPlayerViewControllerDelegate-এর মাধ্যমে একটি কাস্টমাইজযোগ্য ট্রান্সপোর্ট বার পেয়েছে। iOS 16 থেকে শুরু করে, প্লেয়ার পুনরায় তৈরি না করেই গতিশীল মিডিয়া ফাইল প্রতিস্থাপনের জন্য সমর্থন চালু করা হয়েছে।

আধুনিক AVPlayerViewController ProMotion ডিসপ্লের জন্য অপ্টিমাইজ করা হয়েছে — ভিডিও ফ্রেম রেট স্বয়ংক্রিয়ভাবে স্ক্রিন রিফ্রেশ রেটের সাথে সিঙ্ক্রোনাইজ হয়। tvOS-এ, উপাদানটি Siri Remote ফোকাস ইন্টারফেসের সাথে খাপ খায়, এবং macOS-এ QuickTime Player উইন্ডো মোডের সাথে খাপ খায়।

AVPlayerViewController কীভাবে কাজ করে

কন্ট্রোলারের মূল অংশে AVPlayer এবং AVPlayerItem-এর জুড়ি রয়েছে। AVPlayer হল প্লেব্যাক অবজেক্ট যা টাইমলাইন, গতি এবং অবস্থা পরিচালনা করে। AVPlayerItem হল একটি নির্দিষ্ট মিডিয়া ফাইলের চারপাশে একটি র‍্যাপার যাতে মেটাডেটা, ট্র্যাক এবং লোডিং তথ্য থাকে।

প্রારম্ভিককরণের সময়, AVPlayerViewController AVPlayer-এর একটি রেফারেন্স গ্রহণ করে এবং স্বয়ংক্রিয়ভাবে ভিডিও প্রদর্শনের জন্য AVPlayerLayer তৈরি করে। কন্ট্রোলার readyToPlay, লোডিং ত্রুটি এবং প্লেব্যাক সমাপ্তির মতো অবস্থা পরিবর্তন সম্পর্কে AVPlayer KVO বিজ্ঞপ্তিগুলিতে সাবস্ক্রাইব করে।

নিয়ন্ত্রণগুলি (ট্রান্সপোর্ট বার) ট্যাপ করলে প্রদর্শিত হয়। iOS 15+-এ, এগুলি AVPlayerViewControllerCustomizationDelegate-এর মাধ্যমে কাস্টমাইজেশন সমর্থন করে, যা স্ট্যান্ডার্ড বাটন লুকাতে বা প্রতিস্থাপন করতে দেয়।

কন্ট্রোলার লাইফসাইকেল

কন্ট্রোলার তৈরি এবং AVPlayer অ্যাসাইন করার পরে, viewDidLoad মেথড কল করা হয়, যা ভিডিও স্ট্রিম প্রস্তুত করা শুরু করে। যখন AVPlayerItem AVPlayerItemStatusReadyToPlay অবস্থায় ট্রানজিশন করে, প্লেয়ার ফ্রেম প্রদর্শনের জন্য প্রস্তুত হয়। যখন play() মেথড কল করা হয়, Video Toolbox-এর মাধ্যমে ভিডিও স্ট্রিম ডিকোডিং শুরু হয়।

স্ক্রিন ছাড়ার সময়, কন্ট্রোলার স্বয়ংক্রিয়ভাবে প্লেব্যাক বিরাম দেয় এবং ডিকোডার রিসোর্স মুক্ত করে। iOS 13+-এ, অ্যাপ মিনিমাইজ করার সময় প্লেব্যাক বজায় রাখতে, ব্যাকগ্রাউন্ড মোড এবং অডিও সেশন কনফিগার করতে হবে। WWDC 2024 অনুসারে, iOS মিডিয়া সেন্টারের সাথে সিঙ্ক্রোনাইজেশনের জন্য AVPlayerPlaybackCoordinator ব্যবহার করার পরামর্শ দেওয়া হয়।

AVPlayerViewController-এর মূল বৈশিষ্ট্য

উপাদানটি বক্সের বাইরে বৈশিষ্ট্যগুলির একটি সমৃদ্ধ সেট প্রদান করে, যা এটি অধিকাংশ প্রকল্পের জন্য আকর্ষণীয় করে তোলে। নীচে মূল সক্ষমতাগুলি দেওয়া হল যেগুলির জন্য অতিরিক্ত কোডের প্রয়োজন নেই।

• ট্রান্সপোর্ট বার প্লে/পজ, 15-সেকেন্ড স্কিপ, ভলিউম নিয়ন্ত্রণ এবং প্রগতি স্লাইডার সহ।
• সাবটাইটেল সমর্থন — VTT, SRT এবং iTunes Timed Text ফর্ম্যাটে এম্বেডেড এবং বাহ্যিক সাবটাইটেলের স্বয়ংক্রিয় প্রদর্শন।
• AirPlay — Apple TV এবং অন্যান্য AirPlay-সামঞ্জস্যপূর্ণ ডিভাইসে ভিডিও স্ট্রিম করার ক্ষমতা।
• Picture in Picture — একটি বিশেষ বাটন ট্যাপ করলে ফ্লোটিং উইন্ডোতে প্লেব্যাক (iPad এবং iPhone-এ iOS 14+ সহ)।
• পূর্ণ-স্ক্রীন মোড — ডিভাইস ঘুরালে এবং বড় করার বাটনে ট্যাপ করলে স্বয়ংক্রিয় সুইচিং।
• গতি নিয়ন্ত্রণ — প্লেব্যাক গতি নির্বাচনের জন্য বিল্ট-ইন নিয়ন্ত্রণ (0.5x, 1.0x, 1.5x, 2.0x)।
• সুরক্ষিত কন্টেন্ট — DRM সহ HLS কন্টেন্টের জন্য FairPlay Streaming-এর নেটিভ সমর্থন।

AVPlayerViewController ট্রান্সপোর্ট বার

ট্রান্সপোর্ট বার হল ইন্টারফেসের নীচের অংশ যা প্রধান নিয়ন্ত্রণ বাটন ধারণ করে। ডিফল্টরূপে, ব্যবহারকারীর নিষ্ক্রিয়তার 3 সেকেন্ড পরে বারটি লুকিয়ে যায় এবং ট্যাপ করলে প্রদর্শিত হয়। iOS 16+-এ, পৃথক উপাদানগুলির দৃশ্যমানতা নিয়ন্ত্রণ করতে ডেলিগেট ব্যবহার করা যেতে পারে।

ডিবাগ মোডে, AVPlayerViewController.requiresLinearPlayback প্রপার্টি ব্যবহার করে ট্রান্সপোর্ট বার জোর করে দেখানো যেতে পারে, যা ভিডিওকে বিরাম দেওয়া থেকেও রোধ করে। এটি বিজ্ঞাপন বিরতি এবং শিক্ষামূলক কন্টেন্টের জন্য দরকারী।

আপনার প্রকল্পে AVPlayerViewController ইন্টিগ্রেশন

কন্ট্রোলারের বেসিক ইন্টিগ্রেশন কোডের 10 লাইনের বেশি সময় নেয় না। প্রথমে, মিডিয়া ফাইল URL সহ একটি AVPlayer ইনস্ট্যান্স তৈরি করুন, তারপর এটি AVPlayerViewController-এ পাস করুন এবং স্ক্রিনে কন্ট্রোলার প্রদর্শন করুন।

Swift-এ বেসিক প্লেয়ার তৈরি করা

import AVKit

let player = AVPlayer(url: URL(string: "https://example.com/video.mp4")!)
let playerVC = AVPlayerViewController()
playerVC.player = player

present(playerVC, animated: true) {
    player.play()
}

present কল করার পরে, কন্ট্রোলার পূর্ণ স্ক্রিন প্রদর্শিত হয়। ভিডিও নেটওয়ার্ক থেকে লোড হতে শুরু করে, এবং একবার বাফার readyToPlay সীমায় পৌঁছালে, play() কল করার পরে প্লেব্যাক স্বয়ংক্রিয়ভাবে শুরু হয়।

উন্নত নিয়ন্ত্রণের জন্য AVPlayerItem কনফিগার করা

let asset = AVAsset(url: videoURL)
let item = AVPlayerItem(asset: asset)

let metadata = AVMutableMetadataItem()
metadata.key = AVMetadataKey.commonKeyTitle
metadata.value = "আমার ভিডিও"
item.addMetadata(metadata)

let player = AVPlayer(playerItem: item)
let playerVC = AVPlayerViewController()
playerVC.player = player

AVPlayerItem ব্যবহার করলে আপনি মেটাডেটা, টাইমকোড, অডিও ট্র্যাক নির্বাচন এবং সাবটাইটেলের উপর নিয়ন্ত্রণ পান। AVPlayerItem-এর মাধ্যমে, আপনি status প্রপার্টিতে KVO ব্যবহার করে লোডিং প্রগতি, বাফারিং এবং নেটওয়ার্ক ত্রুটিগুলিও মনিটর করতে পারেন।

নিয়ন্ত্রণ কাস্টমাইজ করা

iOS 11 থেকে শুরু করে, ডেভেলপাররা AVPlayerViewControllerDelegate প্রোটোকলের মাধ্যমে ট্রান্সপোর্ট বার কাস্টমাইজ করতে পারেন। playerViewController(_:willBeginFullScreenPresentationWithAnimationCoordinator:) মেথডটি পূর্ণ-স্ক্রীন মোডে প্রবেশের আগে কল করা হয় এবং UI প্রস্তুত করার অনুমতি দেয়।

পৃথক বাটন লুকানোর জন্য, AVPlayerViewController.showsPlaybackControls প্রপার্টি ব্যবহার করুন। false-এ সেট করলে, ট্রান্সপোর্ট বার সম্পূর্ণরূপে অদৃশ্য হয়ে যায়, শুধুমাত্র ভিডিও স্ট্রিম রেখে। কাস্টম ওভারলে উপাদানের জন্য দরকারী।

ডেলিগেট ব্যবহার করে কাস্টমাইজেশন

class CustomPlayerViewController: UIViewController {
    private let playerVC = AVPlayerViewController()

    override func viewDidLoad() {
        super.viewDidLoad()
        playerVC.delegate = self
        playerVC.showsPlaybackControls = true
        playerVC.entersFullScreenWhenPlaybackBegins = true
    }
}

extension CustomPlayerViewController: AVPlayerViewControllerDelegate {
    func playerViewController(
        _ playerViewController: AVPlayerViewController,
        willBeginFullScreenPresentationWithAnimationCoordinator coordinator: UIViewControllerTransitionCoordinator
    ) {
        // ওভারলে বাটন যোগ করুন
    }

    func playerViewController(
        _ playerViewController: AVPlayerViewController,
        didUpdate legibleMediaSelection: AVMediaSelectionGroup
    ) {
        print("নতুন সাবটাইটেল ভাষা নির্বাচিত")
    }
}

ডেলিগেট সাবটাইটেল পরিবর্তন ইভেন্ট, পূর্ণ-স্ক্রীন মোডে প্রবেশ এবং প্রস্থান, সেইসাথে Picture in Picture শুরু এবং শেষ করা ইন্টারসেপ্ট করার অনুমতি দেয়। WWDC 2024-এ, Apple বিশ্লেষণের জন্য ডেলিগেট ব্যবহার করার পরামর্শ দিয়েছে — প্রতিটি ট্রানজিশন 100 ms-এর মধ্যে লগ করুন।

সাবটাইটেল এবং অডিও ট্র্যাক নিয়ে কাজ করা

AVPlayerViewController স্বয়ংক্রিয়ভাবে সমস্ত উপলব্ধ সাবটাইটেল এবং অডিও ট্র্যাক প্রদর্শন করে যদি সেগুলি মিডিয়া ফাইলে এম্বেডেড থাকে বা HLS ম্যানিফেস্টে নির্দিষ্ট করা থাকে। ব্যবহারকারীরা ট্রান্সপোর্ট বারে সাবটাইটেল আইকনে ট্যাপ করলে প্রদর্শিত মেনুর মাধ্যমে সেগুলি পরিবর্তন করতে পারেন।

HLS স্ট্রিমের জন্য, M3U8 ম্যানিফেস্টে উপলব্ধ ভাষা ভেরিয়েন্টের একটি তালিকা থাকে। AVPlayer সংশ্লিষ্ট WebVTT সাবটাইটেল সেগমেন্ট লোড করে এবং রেন্ডারিংয়ের জন্য AVPlayerLayer-এ পাস করে। iOS 16+ AVTextStyleRule-এর মাধ্যমে সাবটাইটেল স্টাইলিং সমর্থন চালু করেছে।

প্রোগ্রামেটিক অডিও ট্র্যাক নির্বাচন

func selectAudioTrack(languageCode: String) {
    guard let group = player.currentItem?
        .asset.mediaSelectionGroup(forMediaCharacteristic: AVMediaCharacteristic.audible)
    else { return }

    for option in group.options {
        if option.extendedLanguageTag?.hasPrefix(languageCode) == true {
            player.currentItem?.select(option, in: group)
        }
    }
}

selectAudioTrack মেথড audible গ্রুপের অডিও অপশনগুলি মধ্যে সেই ভেরিয়েন্ট খুঁজে বের করে যার extendedLanguageTag কাঙ্ক্ষিত ভাষা কোডের সাথে মেলে। এটি বহুভাষিক কন্টেন্টযুক্ত অ্যাপে “মূল অডিও” বৈশিষ্ট্য বাস্তবায়নের অনুমতি দেয়।

iPad-এ Picture in Picture

Picture in Picture (PiP) মোড অন্যান্য অ্যাপের উপরে একটি ফ্লোটিং উইন্ডোতে ভিডিও প্রদর্শনের অনুমতি দেয়। iPad-এ, এই বৈশিষ্ট্যটি iOS 9 থেকে উপলব্ধ, iPhone-এ — iOS 14 থেকে। AVPlayerViewController UIBackgroundModes-এ সাবস্ক্রাইব করলে স্বয়ংক্রিয়ভাবে ট্রান্সপোর্ট বারে একটি PiP বাটন যোগ করে।

PiP সক্রিয় করতে, Info.plist-এ audio এবং airplay মান সহ UIBackgroundModes কী যোগ করুন। তারপরে, কন্ট্রোলারে একটি PiP বাটন দেখা যায়, যা ট্যাপ করলে ভিডিওটি 192x108 পয়েন্টের একটি ফ্লোটিং উইন্ডোতে সংকুচিত হয়।

PiP ইভেন্টগুলি ডেলিগেটের মাধ্যমে হ্যান্ডেল করা হয়: playerViewController(_:willStartPictureInPictureFromFullScreen:) এবং playerViewController(_:didStopPictureInPicture:)। Apple HIG অনুসারে, বিষয়বস্তু পঠনযোগ্যতা বজায় রাখতে ন্যূনতম PiP উইন্ডোর আকার কমপক্ষে 120x68 পয়েন্ট হওয়া উচিত।