এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

আপনার অ্যাপে প্লেব্যাক নিয়ন্ত্রণ যোগ করুন

মিডিয়া প্রদর্শন এবং প্লেব্যাক নিয়ন্ত্রণ করার জন্য একটি অ্যাপ প্লেয়িং মিডিয়ার ব্যবহারকারী ইন্টারফেস উপাদান প্রয়োজন। Media3 লাইব্রেরিতে একটি UI মডিউল রয়েছে যাতে অনেকগুলি UI উপাদান থাকে। UI মডিউলের উপর নির্ভর করতে নিম্নলিখিত নির্ভরতা যোগ করুন:

কোটলিন

implementation("androidx.media3:media3-ui:1.4.1")

গ্রোভি

implementation "androidx.media3:media3-ui:1.4.1"

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

PlayerView প্লেয়ারের দৃষ্টান্ত সংযুক্ত এবং বিচ্ছিন্ন করার জন্য একটি setPlayer পদ্ধতি রয়েছে ( null পাস করে)।

প্লেয়ারভিউ

PlayerView ভিডিও, ইমেজ এবং অডিও প্লেব্যাক উভয়ের জন্য ব্যবহার করা যেতে পারে। এটি ভিডিও প্লেব্যাকের ক্ষেত্রে ভিডিও এবং সাবটাইটেল রেন্ডার করে, ইমেজ প্লেব্যাকের জন্য বিটম্যাপ এবং অডিও ফাইলে মেটাডেটা হিসেবে অন্তর্ভুক্ত আর্টওয়ার্ক প্রদর্শন করতে পারে। আপনি অন্য যেকোনো UI উপাদানের মতো আপনার লেআউট ফাইলে এটি অন্তর্ভুক্ত করতে পারেন। উদাহরণস্বরূপ, একটি PlayerView নিম্নলিখিত XML এর সাথে অন্তর্ভুক্ত করা যেতে পারে:

<androidx.media3.ui.PlayerView
    android:id="@+id/player_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:show_buffering="when_playing"
    app:show_shuffle_button="true"/>

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

একবার লেআউট ফাইলে ভিউ ঘোষণা করা হলে, এটি কার্যকলাপের onCreate পদ্ধতিতে দেখা যেতে পারে:

কোটলিন

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView = findViewById(R.id.player_view)
}

জাভা

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  // ...
  playerView = findViewById(R.id.player_view);
}

যখন একটি প্লেয়ার শুরু করা হয়, setPlayer কল করে এটি ভিউতে সংযুক্ত করা যেতে পারে:

কোটলিন

// Instantiate the player.
val player = ExoPlayer.Builder(context).build()
// Attach player to the view.
playerView.player = player
// Set the media item to be played.
player.setMediaItem(mediaItem)
// Prepare the player.
player.prepare()

জাভা

// Instantiate the player.
player = new ExoPlayer.Builder(context).build();
// Attach player to the view.
playerView.setPlayer(player);
// Set the media item to be played.
player.setMediaItem(mediaItem);
// Prepare the player.
player.prepare();

একটি পৃষ্ঠের ধরন চয়ন করুন

PlayerView এর surface_type অ্যাট্রিবিউট আপনাকে ভিডিও প্লেব্যাকের জন্য ব্যবহৃত সারফেসের ধরন সেট করতে দেয়। spherical_gl_surface_view (যা গোলাকার ভিডিও প্লেব্যাকের জন্য একটি বিশেষ মান) এবং video_decoder_gl_surface_view (যা এক্সটেনশন রেন্ডারার ব্যবহার করে ভিডিও রেন্ডারিংয়ের জন্য) মান ছাড়াও অনুমোদিত মানগুলি হল surface_view , texture_view এবং none । যদি ভিউটি শুধুমাত্র অডিও প্লেব্যাকের জন্য হয়, তবে পৃষ্ঠ তৈরি করা এড়াতে none ব্যবহার করা উচিত নয় কারণ এটি করা ব্যয়বহুল হতে পারে।

যদি ভিউটি নিয়মিত ভিডিও প্লেব্যাকের জন্য হয় তবে surface_view বা texture_view ব্যবহার করা উচিত। ভিডিও প্লেব্যাকের জন্য TextureView এর তুলনায় SurfaceView অনেকগুলি সুবিধা রয়েছে:

অনেক ডিভাইসে উল্লেখযোগ্যভাবে কম পাওয়ার খরচ ।
আরও সঠিক ফ্রেম টাইমিং, যার ফলে ভিডিও প্লেব্যাক মসৃণ হয়।
সক্ষম ডিভাইসগুলিতে উচ্চ মানের HDR ভিডিও আউটপুটের জন্য সমর্থন।
DRM-সুরক্ষিত বিষয়বস্তু চালানোর সময় সুরক্ষিত আউটপুটের জন্য সমর্থন।
অ্যান্ড্রয়েড টিভি ডিভাইসগুলিতে ডিসপ্লের সম্পূর্ণ রেজোলিউশনে ভিডিও সামগ্রী রেন্ডার করার ক্ষমতা যা UI স্তরকে উন্নত করে।

SurfaceView তাই যেখানে সম্ভব TextureView চেয়ে অগ্রাধিকার দেওয়া উচিত। TextureView শুধুমাত্র ব্যবহার করা উচিত যদি SurfaceView আপনার চাহিদা পূরণ না করে। একটি উদাহরণ হল যেখানে Android 7.0 (API স্তর 24) এর আগে ভিডিও পৃষ্ঠের মসৃণ অ্যানিমেশন বা স্ক্রোলিং প্রয়োজন, যেমনটি নিম্নলিখিত নোটগুলিতে বর্ণনা করা হয়েছে। এই ক্ষেত্রে, SDK_INT 24 (Android 7.0) এর কম হলে TextureView ব্যবহার করা বাঞ্ছনীয় এবং অন্যথায় SurfaceView ।

দ্রষ্টব্য: SurfaceView রেন্ডারিং অ্যান্ড্রয়েড 7.0 (এপিআই স্তর 24) পর্যন্ত ভিউ অ্যানিমেশনগুলির সাথে সঠিকভাবে সিঙ্ক্রোনাইজ করা হয়নি। পূর্ববর্তী রিলিজে, এটি অবাঞ্ছিত প্রভাব হতে পারে যখন একটি SurfaceView স্ক্রলিং কন্টেইনারে স্থাপন করা হয়, বা যখন এটি অ্যানিমেশনের শিকার হয়। এই ধরনের প্রভাবগুলির মধ্যে রয়েছে ভিউয়ের বিষয়বস্তু যেখানে প্রদর্শিত হওয়া উচিত সেখানে কিছুটা পিছিয়ে দেখা যাচ্ছে এবং অ্যানিমেশনের শিকার হলে ভিউটি কালো হয়ে যাচ্ছে। অ্যান্ড্রয়েড 7.0-এর আগে মসৃণ অ্যানিমেশন বা ভিডিও স্ক্রোল করার জন্য, তাই SurfaceView এর পরিবর্তে TextureView ব্যবহার করা প্রয়োজন।

দ্রষ্টব্য: একটি SurfaceView এর পৃষ্ঠের জীবনচক্র দৃশ্যমানতার সাথে আবদ্ধ, যেখানে একটি TextureView এর পৃষ্ঠের জীবনচক্র উইন্ডো সংযুক্তি এবং বিচ্ছিন্নতার সাথে আবদ্ধ। অতএব, SurfaceView ব্যবহার করে স্ক্রলিং UIগুলিতে, প্লেব্যাক শুরু করতে বেশি সময় লাগতে পারে কারণ আউটপুট পৃষ্ঠটি কিছুটা পরে উপলব্ধ হয়। Android 14 থেকে, PlayerView এই আচরণ এড়াতে SurfaceView.setSurfaceLifecycle(SURFACE_LIFECYCLE_FOLLOWS_ATTACHMENT) ব্যবহার করে। যদি আপনার অ্যাপ সরাসরি SurfaceView ব্যবহার করে ( PlayerView ছাড়া) তাহলে আপনি এই মোডটি সক্ষম করতে চাইতে পারেন। অ্যান্ড্রয়েড 14 এর আগে, পুনঃব্যবহার করার সময় অফ-স্ক্রিন দৃশ্যগুলি অনুবাদ করে ধ্বংস হওয়া পৃষ্ঠের চারপাশে কাজ করা সম্ভব।

দ্রষ্টব্য: কিছু অ্যান্ড্রয়েড টিভি ডিভাইস তাদের UI স্তরটি এমন একটি রেজোলিউশনে চালায় যা ডিসপ্লের সম্পূর্ণ রেজোলিউশনের চেয়ে কম, ব্যবহারকারীর কাছে উপস্থাপনের জন্য এটিকে উচ্চতর করে। উদাহরণস্বরূপ, 4K ডিসপ্লে আছে এমন একটি Android TV-এ UI স্তরটি 1080p-এ চালানো হতে পারে। এই ধরনের ডিভাইসগুলিতে, ডিসপ্লের সম্পূর্ণ রেজোলিউশনে সামগ্রী রেন্ডার করতে SurfaceView ব্যবহার করা আবশ্যক। Util.getCurrentDisplayModeSize ব্যবহার করে ডিসপ্লের সম্পূর্ণ রেজোলিউশন (এর বর্তমান ডিসপ্লে মোডে) জিজ্ঞাসা করা যেতে পারে। UI লেয়ার রেজোলিউশন Android এর Display.getSize API ব্যবহার করে জিজ্ঞাসা করা যেতে পারে।

অ্যান্ড্রয়েড টিভিতে ডি-প্যাড নেভিগেশন

অ্যান্ড্রয়েড টিভির রিমোট কন্ট্রোলে একটি ডি-প্যাড কন্ট্রোল রয়েছে যা আপনার Activity dispatchKeyEvent(KeyEvent) এ কী ইভেন্ট হিসেবে আসা কমান্ড পাঠায়। এগুলি প্লেয়ার ভিউতে অর্পণ করা দরকার:

কোটলিন

override fun dispatchKeyEvent(event: KeyEvent?): Boolean{
  return playerView.dispatchKeyEvent(event!!) || super.dispatchKeyEvent(event)
}

জাভা

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
  return playerView.dispatchKeyEvent(event) || super.dispatchKeyEvent(event);
}

প্লেব্যাক কন্ট্রোল নেভিগেট করার জন্য এবং বিজ্ঞাপনগুলি এড়িয়ে যাওয়ার জন্য প্লেয়ার ভিউয়ের জন্য ফোকাসের অনুরোধ করা গুরুত্বপূর্ণ। Activity onCreate ফোকাস করার অনুরোধ বিবেচনা করুন:

কোটলিন

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView.requestFocus()
  // ...
}

জাভা

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    playerView.requestFocus();
    // ...
}

আপনি যদি Android TV-তে কম্পোজ ব্যবহার করেন, তাহলে আপনাকে AndroidView ফোকাসযোগ্য করে তুলতে হবে এবং সেই অনুযায়ী AndroidView এ মডিফায়ার প্যারামিটার পাস করে ইভেন্টটি অর্পণ করতে হবে:

AndroidView(
  modifier = modifier
    .focusable()
    .onKeyEvent { playerView.dispatchKeyEvent(it.nativeKeyEvent) },
  factory = { playerView }
)

অঙ্কনযোগ্য ওভাররাইড করুন

PlayerView প্লেব্যাক নিয়ন্ত্রণ এবং অগ্রগতি বার প্রদর্শন করতে PlayerControlView ব্যবহার করে। PlayerControlView দ্বারা ব্যবহৃত অঙ্কনযোগ্যগুলি আপনার অ্যাপ্লিকেশনে সংজ্ঞায়িত একই নামের সাথে অঙ্কনযোগ্য দ্বারা ওভাররাইড করা যেতে পারে। ওভাররাইড করা যেতে পারে এমন নিয়ন্ত্রণ অঙ্কনযোগ্য তালিকার জন্য PlayerControlView Javadoc দেখুন।

আরও কাস্টমাইজেশন

যেখানে উপরে বর্ণিত এর বাইরে কাস্টমাইজেশন প্রয়োজন, আমরা আশা করি যে অ্যাপ ডেভেলপাররা Media3 এর UI মডিউল দ্বারা প্রদত্ত সেগুলি ব্যবহার করার পরিবর্তে তাদের নিজস্ব UI উপাদানগুলি প্রয়োগ করবে৷

কোটলিন

implementation("androidx.media3:media3-ui:1.4.1")

গ্রোভি

implementation "androidx.media3:media3-ui:1.4.1"

প্লেয়ারভিউ

<androidx.media3.ui.PlayerView
    android:id="@+id/player_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:show_buffering="when_playing"
    app:show_shuffle_button="true"/>

কোটলিন

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView = findViewById(R.id.player_view)
}

জাভা

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  // ...
  playerView = findViewById(R.id.player_view);
}

যখন একটি প্লেয়ার শুরু করা হয়, setPlayer কল করে এটি ভিউতে সংযুক্ত করা যেতে পারে:

কোটলিন

// Instantiate the player.
val player = ExoPlayer.Builder(context).build()
// Attach player to the view.
playerView.player = player
// Set the media item to be played.
player.setMediaItem(mediaItem)
// Prepare the player.
player.prepare()

জাভা

// Instantiate the player.
player = new ExoPlayer.Builder(context).build();
// Attach player to the view.
playerView.setPlayer(player);
// Set the media item to be played.
player.setMediaItem(mediaItem);
// Prepare the player.
player.prepare();

একটি পৃষ্ঠের ধরন চয়ন করুন

অনেক ডিভাইসে উল্লেখযোগ্যভাবে কম পাওয়ার খরচ ।
আরও সঠিক ফ্রেম টাইমিং, যার ফলে ভিডিও প্লেব্যাক মসৃণ হয়।
সক্ষম ডিভাইসগুলিতে উচ্চ মানের HDR ভিডিও আউটপুটের জন্য সমর্থন।
DRM-সুরক্ষিত বিষয়বস্তু চালানোর সময় সুরক্ষিত আউটপুটের জন্য সমর্থন।
অ্যান্ড্রয়েড টিভি ডিভাইসগুলিতে ডিসপ্লের সম্পূর্ণ রেজোলিউশনে ভিডিও সামগ্রী রেন্ডার করার ক্ষমতা যা UI স্তরকে উন্নত করে।

অ্যান্ড্রয়েড টিভিতে ডি-প্যাড নেভিগেশন

কোটলিন

override fun dispatchKeyEvent(event: KeyEvent?): Boolean{
  return playerView.dispatchKeyEvent(event!!) || super.dispatchKeyEvent(event)
}

জাভা

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
  return playerView.dispatchKeyEvent(event) || super.dispatchKeyEvent(event);
}

কোটলিন

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView.requestFocus()
  // ...
}

জাভা

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    playerView.requestFocus();
    // ...
}

AndroidView(
  modifier = modifier
    .focusable()
    .onKeyEvent { playerView.dispatchKeyEvent(it.nativeKeyEvent) },
  factory = { playerView }
)

অঙ্কনযোগ্য ওভাররাইড করুন

আরও কাস্টমাইজেশন

কোটলিন

implementation("androidx.media3:media3-ui:1.4.1")

গ্রোভি

implementation "androidx.media3:media3-ui:1.4.1"

প্লেয়ারভিউ

<androidx.media3.ui.PlayerView
    android:id="@+id/player_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:show_buffering="when_playing"
    app:show_shuffle_button="true"/>

কোটলিন

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView = findViewById(R.id.player_view)
}

জাভা

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  // ...
  playerView = findViewById(R.id.player_view);
}

যখন একটি প্লেয়ার শুরু করা হয়, setPlayer কল করে এটি ভিউতে সংযুক্ত করা যেতে পারে:

কোটলিন

// Instantiate the player.
val player = ExoPlayer.Builder(context).build()
// Attach player to the view.
playerView.player = player
// Set the media item to be played.
player.setMediaItem(mediaItem)
// Prepare the player.
player.prepare()

জাভা

// Instantiate the player.
player = new ExoPlayer.Builder(context).build();
// Attach player to the view.
playerView.setPlayer(player);
// Set the media item to be played.
player.setMediaItem(mediaItem);
// Prepare the player.
player.prepare();

একটি পৃষ্ঠের ধরন চয়ন করুন

অনেক ডিভাইসে উল্লেখযোগ্যভাবে কম পাওয়ার খরচ ।
আরও সঠিক ফ্রেম টাইমিং, যার ফলে ভিডিও প্লেব্যাক মসৃণ হয়।
সক্ষম ডিভাইসগুলিতে উচ্চ মানের HDR ভিডিও আউটপুটের জন্য সমর্থন।
DRM-সুরক্ষিত বিষয়বস্তু চালানোর সময় সুরক্ষিত আউটপুটের জন্য সমর্থন।
অ্যান্ড্রয়েড টিভি ডিভাইসগুলিতে ডিসপ্লের সম্পূর্ণ রেজোলিউশনে ভিডিও সামগ্রী রেন্ডার করার ক্ষমতা যা UI স্তরকে উন্নত করে।

অ্যান্ড্রয়েড টিভিতে ডি-প্যাড নেভিগেশন

কোটলিন

override fun dispatchKeyEvent(event: KeyEvent?): Boolean{
  return playerView.dispatchKeyEvent(event!!) || super.dispatchKeyEvent(event)
}

জাভা

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
  return playerView.dispatchKeyEvent(event) || super.dispatchKeyEvent(event);
}

কোটলিন

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView.requestFocus()
  // ...
}

জাভা

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    playerView.requestFocus();
    // ...
}

AndroidView(
  modifier = modifier
    .focusable()
    .onKeyEvent { playerView.dispatchKeyEvent(it.nativeKeyEvent) },
  factory = { playerView }
)