دوربین

دوربین کلاس عمومی

نمایانگر یک دوربین مجازی است که منظری را که از طریق آن صحنه مشاهده می شود را تعیین می کند.

اگر دوربین بخشی از ArSceneView باشد، دوربین به‌طور خودکار ژست دوربین را از ARCore ردیابی می‌کند. علاوه بر این، متدهای زیر هنگام فراخوانی، UnsupportedOperationException را پرتاب می‌کنند:

• setParent(NodeParent) - والد دوربین را نمی توان تغییر داد، همیشه صحنه است.
• setLocalPosition(Vector3) - موقعیت دوربین را نمی توان تغییر داد، با ژست دوربین ARCore کنترل می شود.
• setLocalRotation(Quaternion) - چرخش دوربین را نمی توان تغییر داد، با ژست دوربین ARCore کنترل می شود.
• setWorldPosition(Vector3) - موقعیت دوربین را نمی توان تغییر داد، با ژست دوربین ARCore کنترل می شود.
• setWorldRotation(Quaternion) - چرخش دوربین را نمی توان تغییر داد، با ژست دوربین ARCore کنترل می شود.

تمام عملکردهای دیگر در Node پشتیبانی می شود. می توانید به موقعیت و چرخش دوربین دسترسی داشته باشید، شکل برخورد را به دوربین اختصاص دهید یا کودکان را به دوربین اضافه کنید. غیرفعال کردن دوربین، رندر را خاموش می کند.

روش های عمومی

شناور	getFarClipPlane ()
شناور	getNearClipPlane ()
شناور	getVerticalFovDegrees () میدان دید عمودی دوربین را دریافت می کند.
اشعه	screenPointToRay (فلوت x، شناور y) یک پرتو در فضای جهان را محاسبه می کند که از صفحه نزدیک دوربین می رود و از نقطه ای در فضای صفحه می گذرد.
خالی	setLocalPosition (موقعیت Vector3 ) موقعیت دوربین را تنظیم کنید.
خالی	setLocalRotation (چرخش کواترنیون ) چرخش دوربین را تنظیم کنید.
خالی	setParent (والدین NodeParent ) عملیات پشتیبانی نشده
خالی	setVerticalFovDegrees (float verticalFov) میدان دید عمودی دوربین غیر ar را بر حسب درجه تنظیم می کند.
خالی	setWorldPosition ( وکتور 3 موقعیت) موقعیت دوربین را تنظیم کنید.
خالی	setWorldRotation (چرخش کواترنیون ) چرخش دوربین را تنظیم کنید.
بردار3	worldToScreenPoint ( وکتور 3 نقطه) یک نقطه از فضای جهان را به فضای صفحه تبدیل کنید.

روش های ارثی

از کلاس com.google.ar.sceneform.Node

خالی	addLifecycleListener ( Node.LifecycleListener lifecycleListener) شنونده ای اضافه می کند که هنگام وقوع رویدادهای چرخه حیات گره فراخوانی می شود.
خالی	addTransformChangedListener ( Node.TransformChangedListener transformChangedListener) شنونده ای اضافه می کند که با تغییر تبدیل گره فراخوانی می شود.
خالی	callOnHierarchy (Consumer< Node > Consumer) سلسله مراتب را طی می کند و روی هر گره (از جمله این گره) متدی را فراخوانی می کند.
بولی نهایی	canAddChild (فرزند گره ، دلیل شکست StringBuilder )
گره	findInHierarchy (گزاره < گره > شرط) سلسله مراتب را طی می کند تا اولین گره (از جمله این گره) را که شرایطی را برآورده می کند پیدا کند.
بردار نهایی 3	بازگشت () بردار پشت فضای جهان (+z) این گره را دریافت می کند.
CollisionShape	getCollisionShape () شکل مورد استفاده برای برخورد با این گره را دریافت می کند.
بردار نهایی 3	فرود آمدن () بردار پایین فضای جهان (-y) این گره را دریافت می کند.
بردار نهایی 3	به جلو () بردار رو به جلو فضای جهان (-z) این گره را دریافت می کند.
بردار نهایی 3	getLeft () بردار سمت چپ فضای جهان (-x) این گره را دریافت می کند.
سبک	getLight () نور فعلی را دریافت می کند که قابل تغییر است.
بردار نهایی 3	getLocalPosition () یک کپی از موقعیت گره ها نسبت به والد خود (فضای محلی) دریافت می کند.
کواترنیون نهایی	getLocalRotation () یک کپی از چرخش گره ها نسبت به والد خود (فضای محلی) دریافت می کند.
بردار نهایی 3	getLocalScale () یک کپی از مقیاس گره ها را نسبت به والد خود (فضای محلی) دریافت می کند.
رشته نهایی	getName () نام گره را برمی گرداند.
گره نهایی	getParent () والد این گره را برمی گرداند.
قابل اجرا	getRenderable () رندرپذیر را برای نمایش این گره دریافت می کند.
بردار نهایی 3	درست بگیر () بردار راست فضای جهان (+x) این گره را دریافت می کند.
صحنه پایانی	getScene () صحنه ای را که این گره بخشی از آن است، برمی گرداند، اگر بخشی از هیچ صحنه ای نباشد، باطل است.
بردار نهایی 3	بلند شدن () بردار فضای جهانی (+y) این گره را دریافت می کند.
بردار نهایی 3	getWorldPosition () یک کپی از موقعیت گره ها در فضای جهانی دریافت کنید.
کواترنیون نهایی	getWorldRotation () یک کپی از چرخش گره‌ها به فضا دریافت می‌کند.
بردار نهایی 3	getWorldScale () یک کپی از گره های مقیاس جهان-فضا می گیرد.
بولی نهایی	فعال است () اگر گره فعال باشد true را برمی گرداند.
بولی نهایی	isDescendantOf (جد NodeParent ) بررسی می کند که آیا والد گره داده شده اجداد این گره به صورت بازگشتی است یا خیر.
بولی نهایی	فعال است () حالت فعال این گره را دریافت می کند.
بولی	isTopLevel () اگر این گره در سطح بالایی باشد، true را برمی‌گرداند.
بردار نهایی 3	localToWorldDirection ( جهت Vector3 ) یک جهت را از فضای محلی این گره به فضای جهانی تبدیل می کند.
بردار نهایی 3	localToWorldPoint (نقطه برداری 3) یک نقطه در فضای محلی این گره را به فضای جهانی تبدیل می کند.
خالی	فعال کردن () زمانی که این گره فعال می شود کنترل می کند.
باطل نهایی	onAddChild (فرزند گره )
خالی	در غیرفعال کردن () زمانی که این گره غیرفعال می شود رسیدگی می کند.
باطل نهایی	onRemoveChild (فرزند گره )
بولی	onTouchEvent ( HitTestResult hitTestResult، MotionEvent motionEvent) هنگامی که این گره لمس می شود، دستگیر می شود.
خالی	onTransformChange ( گره مبدا گره) زمانی که تبدیل این گره تغییر می کند، کنترل می کند.
خالی	onUpdate ( FrameTime frameTime) زمانی که این گره به روز می شود رسیدگی می کند.
خالی	removeLifecycleListener ( Node.LifecycleListener lifecycleListener) شنونده ای را حذف می کند که هنگام وقوع رویدادهای چرخه حیات گره فراخوانی می شود.
خالی	removeTransformChangedListener ( Node.TransformChangedListener transformChangedListener) شنونده ای را حذف می کند که با تغییر تبدیل گره فراخوانی می شود.
خالی	setCollisionShape ( CollisionShape collisionShape) شکل را برای تشخیص برخوردهای این Node تنظیم می کند.
باطل نهایی	setEnabled (بولی فعال) وضعیت فعال این گره را تنظیم می کند.
خالی	setLight ( نور نور) Light را برای نمایش تنظیم می کند.
خالی	setLocalPosition (موقعیت Vector3 ) موقعیت این گره را نسبت به والد آن (فضای محلی) تنظیم می کند.
خالی	setLocalRotation (چرخش کواترنیون ) چرخش این گره را نسبت به والد آن (فضای محلی) تنظیم می کند.
خالی	setLocalScale (مقیاس Vector3 ) مقیاس این گره را نسبت به والد آن (فضای محلی) تنظیم می کند.
باطل نهایی	setLookDirection ( Vector3 lookDirection ) جهتی را تنظیم می کند که گره در فضای جهان به آن نگاه می کند.
باطل نهایی	setLookDirection ( Vector3 lookDirection ، Vector3 upDirection ) جهتی را تنظیم می کند که گره در فضای جهان به آن نگاه می کند.
باطل نهایی	setName (نام رشته ) نام این گره را تنظیم می کند.
خالی	setOnTapListener ( Node.OnTapListener در TapListener) هنگامی که روی این گره ضربه زده می شود، یک تماس برگشتی را ثبت می کند تا فراخوانی شود.
خالی	setOnTouchListener ( Node.OnTouchListener onTouchListener) هنگامی که یک رویداد لمسی به این گره ارسال می شود، یک تماس برگشتی را برای فراخوانی ثبت می کند.
خالی	setParent (والدین NodeParent ) گره والد این گره را تغییر می دهد.
خالی	setRenderable ( renderable renderable ) Renderable را برای نمایش برای این گره تنظیم می کند.
خالی	setWorldPosition ( وکتور 3 موقعیت) موقعیت فضای جهانی این گره را تنظیم می کند.
خالی	setWorldRotation (چرخش کواترنیون ) چرخش جهان-فضای این گره را تنظیم می کند.
خالی	setWorldScale (مقیاس Vector3 ) مقیاس فضای جهانی این گره را تنظیم می کند.
رشته	toString ()
بردار نهایی 3	worldToLocalDirection ( جهت Vector3 ) یک جهت را از فضای جهان به فضای محلی این گره تبدیل می کند.
بردار نهایی 3	worldToLocalPoint (نقطه Vector3 ) یک نقطه در فضای جهان را به فضای محلی این گره تبدیل می کند.

از کلاس com.google.ar.sceneform.NodeParent

باطل نهایی	addChild (فرزند گره ) یک گره را به عنوان فرزند این NodeParent اضافه می کند.
خالی	callOnHierarchy (Consumer< Node > Consumer) سلسله مراتب را طی کنید و روی هر گره یک متد فراخوانی کنید.
بولی	canAddChild (فرزند گره ، دلیل شکست StringBuilder )
گره	findByName (نام رشته ) سلسله مراتب را طی کنید تا اولین گره با نام مشخص را پیدا کنید.
گره	findInHierarchy (گزاره < گره > شرط) سلسله مراتب را طی کنید تا اولین گره ای را پیدا کنید که یک شرط را برآورده می کند.
فهرست نهایی < گره >	getChildren () فهرستی تغییرناپذیر از فرزندان این والدین را برمی‌گرداند.
خالی	onAddChild (فرزند گره )
خالی	onRemoveChild (فرزند گره )
باطل نهایی	removeChild (فرزند گره ) یک گره را از فرزندان این NodeParent حذف می کند.

از کلاس java.lang.Object

هدف - شی	کلون ()
بولی	برابر است ( شیء arg0)
خالی	نهایی کردن ()
کلاس نهایی <?>	getClass ()
بین المللی	هش کد ()
باطل نهایی	اطلاع رسانی ()
باطل نهایی	اطلاع رسانی به همه ()
رشته	toString ()
باطل نهایی	صبر کنید (long arg0، int arg1)
باطل نهایی	صبر کنید (طولانی arg0)
باطل نهایی	صبر کن ()

روش های عمومی

شناور عمومی getFarClipPlane ()

شناور عمومی getNearClipPlane ()

عمومی float getVerticalFovDegrees ()

میدان دید عمودی دوربین را دریافت می کند.

اگر این یک دوربین AR است، بر اساس اطلاعات دوربین ARCore محاسبه می‌شود و می‌تواند بین دستگاه‌ها متفاوت باشد. تا زمانی که اولین فریم پس از جلسه ARCore از سر گرفته نشود، نمی توان آن را محاسبه کرد، در این صورت یک IllegalStateException پرتاب می شود.

در غیر این صورت، مقدار تعیین شده توسط setVerticalFovDegrees(float) با پیش‌فرض 90 درجه را برمی‌گرداند.

پرتاب می کند

IllegalStateException	اگر قبل از اولین فریم پس از از سرگیری ARCore فراخوانی شود

پرتو عمومی صفحه نمایشPointToRay (فلوت x، شناور y)

یک پرتو در فضای جهان را محاسبه می کند که از صفحه نزدیک دوربین می رود و از نقطه ای در فضای صفحه می گذرد. فضای صفحه در مختصات صفحه دستگاه Android است: TopLeft = (0، 0) BottomRight = (عرض صفحه، ارتفاع صفحه) فضای مختصات دستگاه تحت تأثیر جهت گیری دستگاه قرار نمی گیرد.

مولفه های

ایکس	موقعیت X در مختصات صفحه نمایش دستگاه.
y	موقعیت Y در مختصات صفحه نمایش دستگاه.

public void setLocalPosition ( موقعیت Vector3)

موقعیت دوربین را تنظیم کنید. دوربین همیشه isTopLevel() است، بنابراین مانند setWorldPosition(Vector3) عمل می کند.

اگر دوربین بخشی از یک ArSceneView ، این یک عملیات پشتیبانی نشده است. موقعیت دوربین را نمی توان تغییر داد، با ژست دوربین ARCore کنترل می شود.

مولفه های

موقعیت	موقعیت برای درخواست.

public void setLocalRotation (چرخش کواترنیون )

چرخش دوربین را تنظیم کنید. دوربین همیشه isTopLevel() است، بنابراین مانند setWorldRotation(Quaternion) عمل می کند.

اگر دوربین بخشی از یک ArSceneView ، این یک عملیات پشتیبانی نشده است. چرخش دوربین را نمی توان تغییر داد، با ژست دوربین ARCore کنترل می شود.

مولفه های

چرخش	چرخش اعمال شود.

public void setParent ( NodeParent والد)

عملیات پشتیبانی نشده والد دوربین را نمی توان تغییر داد، همیشه صحنه است.

مولفه های

والدین	والد جدیدی که این گره فرزند آن خواهد بود. در صورت تهی بودن، این گره از والد خود جدا می شود.

مجموعه فضای خالی عمومی VerticalFovDegrees (float verticalFov)

میدان دید عمودی دوربین غیر ar را بر حسب درجه تنظیم می کند. اگر این یک دوربین AR است، پس fov از ARCore می آید و نمی توان آن را تنظیم کرد، بنابراین یک استثنا ایجاد می شود. پیش فرض 90 درجه است.

مولفه های

verticalFov

پرتاب می کند

UnsupportedOperationException	اگر این یک دوربین AR است

public void setWorldPosition ( موقعیت Vector3)

موقعیت دوربین را تنظیم کنید. دوربین همیشه isTopLevel() است، بنابراین مانند setLocalPosition(Vector3) عمل می کند.

اگر دوربین بخشی از یک ArSceneView ، این یک عملیات پشتیبانی نشده است. موقعیت دوربین را نمی توان تغییر داد، با ژست دوربین ARCore کنترل می شود.

مولفه های

موقعیت	موقعیت برای درخواست.

public void setWorldRotation (چرخش کواترنیون )

چرخش دوربین را تنظیم کنید. دوربین همیشه isTopLevel() است، بنابراین مانند setLocalRotation(Quaternion) عمل می کند.

اگر دوربین بخشی از ArSceneView است، این یک عملیات پشتیبانی نشده است. چرخش دوربین را نمی توان تغییر داد، با ژست دوربین ARCore کنترل می شود.

مولفه های

چرخش	چرخش اعمال شود.

public Vector3 worldToScreenPoint ( نقطه Vector3)

یک نقطه از فضای جهان را به فضای صفحه تبدیل کنید.

مقدار X زمانی که نقطه از نمای سمت چپ است، بین 0 و عرض SceneView زمانی که نقطه در داخل درگاه دید قرار دارد، منفی است، و زمانی که نقطه در سمت راست درگاه دید قرار دارد، از عرض بیشتر است.

مقدار Y زمانی منفی است که نقطه در زیر نما باشد، بین 0 و ارتفاع SceneView زمانی که نقطه در داخل درگاه دید قرار دارد، و از ارتفاع زمانی که نقطه بالای درگاه دید باشد، بزرگتر است.

مقدار Z همیشه 0 است زیرا مقدار بازگشتی یک مختصات دو بعدی است.

مولفه های

نقطه	نقطه در فضای جهان برای تبدیل

برمی گرداند

• یک بردار جدید که نشان دهنده نقطه در فضای صفحه است.