আপনার অ্যাপে স্পেশিয়াল ভিডিও যোগ করা

প্রযোজ্য XR ডিভাইস
এই নির্দেশিকা আপনাকে এই ধরনের XR ডিভাইসের জন্য অভিজ্ঞতা তৈরি করতে সাহায্য করে।
XR হেডসেট
তারযুক্ত XR গ্লাস

Jetpack XR SDK সমতল সারফেসে ঘনদর্শনমূলক পাশাপাশি ভিডিও প্লেব্যাক করতে সাহায্য করে। ঘনদর্শনমূলক ভিডিওর প্রতিটি ফ্রেমে বাঁ ও ডান চোখের জন্য আলাদা ছবি থাকে যাতে দর্শক গভীরতা অনুভব করতে পারেন—একে স্টেরিওপসিস বলা হয়।

অন্যান্য ফর্ম ফ্যাক্টরে Android ডেভেলপমেন্টের জন্য ব্যবহৃত স্ট্যান্ডার্ড মিডিয়া API-এর মাধ্যমে আপনি Android XR অ্যাপে নন-স্টেরিওস্কোপিক 2D ভিডিও রেন্ডার করতে পারবেন।

Jetpack SceneCore ব্যবহার করে পাশাপাশি ভিডিও চালান

পাশাপাশি ভিডিওর ক্ষেত্রে, প্রতিটি ঘনদর্শনমূলক ফ্রেমকে দুটি ছবি হিসেবে দেখানো হয় যা অনুভূমিকভাবে একে অপরের পাশে সাজানো থাকে। উপরের ও নিচের ভিডিও ফ্রেম একে অপরের সাথে উল্লম্বভাবে সাজানো থাকে।

পাশাপাশি ভিডিও কোনও কোডেক নয়, বরং ঘনদর্শনমূলক ফ্রেম সাজানোর একটি উপায়, যার অর্থ হল এটি Android-এ কাজ করে এমন যেকোনও কোডেক-এ এনকোড করা যেতে পারে।

আপনি Media3 Exoplayer ব্যবহার করে পাশাপাশি ভিডিও লোড করতে পারবেন এবং তারপরে নতুন SurfaceEntity ব্যবহার করে এটি রেন্ডার করতে পারবেন। SurfaceEntity তৈরি করতে, SurfaceEntity.create কল করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

val stereoSurfaceEntity = SurfaceEntity.create(
    session = xrSession,
    stereoMode = SurfaceEntity.StereoMode.SIDE_BY_SIDE,
    pose = Pose(Vector3(0.0f, 0.0f, -1.5f)),
    shape = SurfaceEntity.Shape.Quad(FloatSize2d(1.0f, 1.0f))
)
val videoUri = Uri.Builder()
    .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
    .path("sbs_video.mp4")
    .build()
val mediaItem = MediaItem.fromUri(videoUri)

val exoPlayer = ExoPlayer.Builder(this).build()
exoPlayer.setVideoSurface(stereoSurfaceEntity.getSurface())
exoPlayer.setMediaItem(mediaItem)
exoPlayer.prepare()
exoPlayer.play()

Jetpack SceneCore ব্যবহার করে MV-HEVC ভিডিও চালান

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

পাশাপাশি ভিডিওর মতো, আপনি এটি Media3 Exoplayer ব্যবহার করে লোড করতে পারেন এবং SurfaceEntity ব্যবহার করে রেন্ডার করতে পারেন। SurfaceEntity.create কল করার সময় stereoMode প্যারামিটারে আপনার MV-HEVC ফাইল বাঁদিকে নাকি ডানদিকে প্রাইমারি তা উল্লেখ করতে হবে।

// Create the SurfaceEntity with the StereoMode corresponding to the MV-HEVC content
val stereoSurfaceEntity = SurfaceEntity.create(
    session = xrSession,
    stereoMode = SurfaceEntity.StereoMode.MULTIVIEW_LEFT_PRIMARY,
    pose = Pose(Vector3(0.0f, 0.0f, -1.5f)),
    shape = SurfaceEntity.Shape.Quad(FloatSize2d(1.0f, 1.0f))
)
val videoUri = Uri.Builder()
    .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
    .path("mvhevc_video.mp4")
    .build()
val mediaItem = MediaItem.fromUri(videoUri)

val exoPlayer = ExoPlayer.Builder(this).build()
exoPlayer.setVideoSurface(stereoSurfaceEntity.getSurface())
exoPlayer.setMediaItem(mediaItem)
exoPlayer.prepare()
exoPlayer.play()

Jetpack SceneCore ব্যবহার করে DRM-সুরক্ষিত স্পেশিয়াল ভিডিও চালান

Jetpack XR SDK, Android-এর বিল্ট-ইন ডিজিটাল রাইটস ম্যানেজমেন্ট (DRM) ফ্রেমওয়ার্ক ব্যবহার করে এনক্রিপ্ট করা ভিডিও স্ট্রিম প্লেব্যাক করতে সাহায্য করে। DRM নিরাপদ ডিস্ট্রিবিউশন চালু করে এবং অননুমোদিত কপি বা প্লেব্যাক আটকানোর মাধ্যমে আপনার কন্টেন্ট সুরক্ষিত রাখে।

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

Jetpack SceneCore-এর মাধ্যমে DRM-সুরক্ষিত ভিডিও চালাতে, আপনাকে এগুলি করতে হবে:

  1. সুরক্ষিত সারফেসের অনুরোধ করতে SurfaceEntity কনফিগার করুন।
  2. কী এক্সচেঞ্জ ম্যানেজ করার জন্য প্রয়োজনীয় DRM তথ্য দিয়ে Media3 Exoplayer কনফিগার করুন।
  3. প্লেয়ারের আউটপুট SurfaceEntity-এর সারফেসে সেট করুন।

নিম্নলিখিত উদাহরণ থেকে জানতে পারবেন যে কীভাবে ExoPlayer কনফিগার করে DRM-সুরক্ষিত স্ট্রিম চালানো যায় এবং SurfaceEntity-এ রেন্ডার করা যায়:

// Create a SurfaceEntity with DRM content

// Define the URI for your DRM-protected content and license server.
val videoUri = "https://your-content-provider.com/video.mpd"
val drmLicenseUrl = "https://your-license-server.com/license"

// Create the SurfaceEntity with the PROTECTED content security level.
val protectedSurfaceEntity = SurfaceEntity.create(
    session = xrSession,
    stereoMode = SurfaceEntity.StereoMode.SIDE_BY_SIDE,
    pose = Pose(Vector3(0.0f, 0.0f, -1.5f)),
    shape = SurfaceEntity.Shape.Quad(FloatSize2d(1.0f, 1.0f)),
    surfaceProtection = SurfaceEntity.SurfaceProtection.PROTECTED
)

// Build a MediaItem with the necessary DRM configuration.
val mediaItem = MediaItem.Builder()
    .setUri(videoUri)
    .setDrmConfiguration(
        MediaItem.DrmConfiguration.Builder(C.WIDEVINE_UUID)
            .setLicenseUri(drmLicenseUrl)
            .build()
    )
    .build()

// Initialize ExoPlayer and set the protected surface.
val exoPlayer = ExoPlayer.Builder(this).build()
exoPlayer.setVideoSurface(protectedSurfaceEntity.getSurface())

// Set the media item and start playback.
exoPlayer.setMediaItem(mediaItem)
exoPlayer.prepare()
exoPlayer.play()

Android-এর মিডিয়া DRM ফ্রেমওয়ার্কের আরও বিস্তারিত ওভারভিউয়ের জন্য, source.android.com-এ মিডিয়া DRM ডকুমেন্টেশন দেখুন।

Jetpack SceneCore ব্যবহার করে ১৮০-ডিগ্রি এবং ৩৬০-ডিগ্রি ভিডিও চালান

SurfaceEntity-এ হেমিস্ফেরিক্যাল সারফেসে ১৮০° ভিডিও এবং স্ফেরিক্যাল সারফেসে ৩৬০° ভিডিও প্লেব্যাক করা যায়। radius প্যারামিটারটি সাধারণত মিটারে সংশ্লিষ্ট সারফেসের রেডিয়াল সাইজকে বোঝায়।

১৮০° হেমিস্ফিয়ার ও ৩৬০° স্ফিয়ারে প্লেব্যাকের জন্য কীভাবে SurfaceEntity সেট-আপ করতে হয় তা নিম্নলিখিত কোড থেকে জানতে পারবেন। এই ক্যানভাস শেপ ব্যবহার করার সময়, ব্যবহারকারীর মাথার পোজের সুবিধা নিয়ে সারফেসের পজিশন ঠিক করুন যাতে ইমারসিভ অভিজ্ঞতা প্রদান করা যায়।

val devicePose = ArDevice.getInstance(xrSession).state.value.devicePose
val activitySpacePose = xrSession.scene.perceptionSpace.transformPoseTo(devicePose, xrSession.scene.activitySpace)

// Set up the surface for playing a 180° video on a hemisphere.
val hemisphereStereoSurfaceEntity =
    SurfaceEntity.create(
        session = xrSession,
        stereoMode = SurfaceEntity.StereoMode.SIDE_BY_SIDE,
        pose = activitySpacePose,
        shape = SurfaceEntity.Shape.Hemisphere(1.0f),
    )
// ... and use the surface for playing the media.

val devicePose = ArDevice.getInstance(xrSession).state.value.devicePose
val activitySpacePose = xrSession.scene.perceptionSpace.transformPoseTo(devicePose, xrSession.scene.activitySpace)
// Set up the surface for playing a 360° video on a sphere.
val sphereStereoSurfaceEntity =
    SurfaceEntity.create(
        session = xrSession,
        stereoMode = SurfaceEntity.StereoMode.TOP_BOTTOM,
        pose = activitySpacePose,
        shape = SurfaceEntity.Shape.Sphere(1.0f),
    )
// ... and use the surface for playing the media.

উন্নত SurfaceEntity কন্ট্রোল

ভিডিও এবং ইমেজ রেন্ডারিংয়ের উপর আরও উন্নত কন্ট্রোলের জন্য, যেমন কাস্টম মেটেরিয়াল এফেক্ট প্রয়োগ করা, আপনি SceneCore লাইব্রেরি থেকে সরাসরি SurfaceEntity-এর সাথে কাজ করতে পারেন।

নিম্নলিখিত বিভাগে SurfaceEntity-এ উপলভ্য কিছু উন্নত ফিচারের ব্যাপারে বর্ণনা করা হয়েছে।

এজ ফেদারিং প্রয়োগ করুন

edgeFeatheringParams প্রপার্টি সেট করে সারফেসের কিনারা সফ্ট করুন যাতে এটি পরিবেশের সাথে মিশে যায়।

// Create a SurfaceEntity.
val surfaceEntity = SurfaceEntity.create(
    session = xrSession,
    pose = Pose(Vector3(0.0f, 0.0f, -1.5f))
)

// Feather the edges of the surface.
surfaceEntity.edgeFeatheringParams =
    SurfaceEntity.EdgeFeatheringParams.RectangleFeather(0.1f, 0.1f)

আলফা মাস্ক প্রয়োগ করুন

অ-আয়তাকার সারফেস তৈরি করতে বা স্বচ্ছতা এফেক্ট যোগ করতে আলফা মাস্ক প্রয়োগ করুন। প্রথমে, অ্যাসেট থেকে Texture লোড করুন, তারপর এটি primaryAlphaMaskTexture প্রপার্টিতে অ্যাসাইন করুন:

// Create a SurfaceEntity.
val surfaceEntity = SurfaceEntity.create(
    session = xrSession,
    pose = Pose(Vector3(0.0f, 0.0f, -1.5f))
)

// Load the texture in a coroutine scope.
activity.lifecycleScope.launch {
    val alphaMaskTexture =
        Texture.create(
            xrSession,
            Paths.get("textures", "alpha_mask.png"),
        )

    // Apply the alpha mask.
    surfaceEntity.primaryAlphaMaskTexture = alphaMaskTexture

    // To remove the mask, set the property to null.
    surfaceEntity.primaryAlphaMaskTexture = null
}

Jetpack Compose for XR ব্যবহার করে স্পেশাল ভিডিও চালানো

আপনি যদি XR-এর জন্য Jetpack Compose ব্যবহার করে কীভাবে ভিডিও চালাতে হয় তা শিখতে আগ্রহী হন, তাহলে ছবি বা ভিডিও কন্টেন্টের জন্য সারফেস যোগ করা সম্পর্কে জানুন।