{"id":90189,"date":"2026-10-28T14:25:00","date_gmt":"2026-10-28T13:25:00","guid":{"rendered":"https:\/\/codescriptum.pl\/blog\/model-3d-nie-dziala-w-ar-na-iphonie\/"},"modified":"2026-10-28T14:25:00","modified_gmt":"2026-10-28T13:25:00","slug":"model-3d-nie-dziala-w-ar-na-iphonie","status":"publish","type":"post","link":"https:\/\/codescriptum.pl\/blog\/model-3d-nie-dziala-w-ar-na-iphonie\/","title":{"rendered":"Model 3D nie dzia\u0142a w AR na iPhonie - plik USDZ, typ MIME i przycisk AR krok po kroku"},"content":{"rendered":"<p>Model 3D nie dzia\u0142a w AR na iPhonie najcz\u0119\u015bciej dlatego, \u017ce strona podaje tylko plik GLB, a AR Quick Look, czyli systemowy podgl\u0105d AR w iOS, przyjmuje pliki .usdz i .reality. Drug\u0105 cz\u0119st\u0105 przyczyn\u0105 jest serwer, kt\u00f3ry wysy\u0142a plik USDZ z niew\u0142a\u015bciwym typem MIME, albo link zbudowany niezgodnie z wymaganiami Safari. Naprawa zwykle sprowadza si\u0119 do przygotowania pliku USDZ, jednej zmiany na serwerze i poprawnego przycisku AR.<\/p>\n<h2>Jak to wygl\u0105da<\/h2>\n<ul>\n<li>na Androidzie przycisk AR dzia\u0142a, a na iPhonie w og\u00f3le si\u0119 nie pojawia,<\/li>\n<li>przycisk jest widoczny, ale po dotkni\u0119ciu nic si\u0119 nie dzieje,<\/li>\n<li>zamiast podgl\u0105du AR otwiera si\u0119 strona z ikon\u0105 pliku albo pobieranie,<\/li>\n<li>AR dzia\u0142a w Safari, ale nie po wej\u015bciu z reklamy w aplikacji spo\u0142eczno\u015bciowej,<\/li>\n<li>model otwiera si\u0119 w AR, ale ma inne kolory, z\u0142\u0105 skal\u0119 albo le\u017cy na boku.<\/li>\n<\/ul>\n<h2>Dlaczego AR nie dzia\u0142a na iPhonie?<\/h2>\n<h3>Brak pliku USDZ<\/h3>\n<p>Wed\u0142ug dokumentacji Apple tre\u015bci do AR Quick Look dostarcza si\u0119 w formacie .usdz albo .reality. Plik GLB, kt\u00f3ry dzia\u0142a w przegl\u0105darce i w Scene Viewer na Androidzie, na iPhonie nie otworzy si\u0119 w AR. Je\u015bli strona korzysta z komponentu model-viewer i nie podaje osobnego pliku w atrybucie ios-src, komponent mo\u017ce wygenerowa\u0107 USDZ w locie po naci\u015bni\u0119ciu przycisku AR, ale tylko wtedy, gdy tryb quick-look jest w\u0142\u0105czony w atrybucie ar-modes.<\/p>\n<h3>Niew\u0142a\u015bciwy typ MIME na serwerze<\/h3>\n<p>Safari oczekuje, \u017ce plik USDZ b\u0119dzie wysy\u0142any z typem model\/vnd.usdz+zip. Cz\u0119\u015b\u0107 serwer\u00f3w nie zna tego rozszerzenia i wysy\u0142a plik jako og\u00f3lny typ binarny, a wtedy iPhone nie rozpoznaje go jako modelu AR. Problem cz\u0119sto wychodzi dopiero po przeniesieniu strony na inny hosting albo po dodaniu CDN.<\/p>\n<h3>Link AR zbudowany niezgodnie z wymaganiami<\/h3>\n<p>Przy r\u0119cznie zbudowanym przycisku Safari otwiera AR Quick Look tylko wtedy, gdy link ma atrybut rel=\"ar\" i zawiera dok\u0142adnie jeden element img lub picture. Link tekstowy, link z kilkoma elementami w \u015brodku albo przycisk otwieraj\u0105cy plik przez JavaScript prowadz\u0105 do zwyk\u0142ej strony z plikiem.<\/p>\n<h3>Przegl\u0105darka wbudowana w aplikacj\u0119<\/h3>\n<p>Dokumentacja Apple opisuje otwieranie takiego linku w Safari i w widoku przegl\u0105darki wy\u015bwietlanym w aplikacji, ale w praktyce przegl\u0105darki wbudowane w aplikacje spo\u0142eczno\u015bciowe nie zawsze przekazuj\u0105 model do AR Quick Look. Klient, kt\u00f3ry wszed\u0142 z reklamy, widzi wtedy przycisk, kt\u00f3ry nic nie robi.<\/p>\n<h3>Problemy z samym plikiem<\/h3>\n<p>Plik USDZ przekonwertowany automatycznie mo\u017ce mie\u0107 inne materia\u0142y ni\u017c GLB, a je\u015bli model \u017ar\u00f3d\u0142owy zapisano w milimetrach albo z osi\u0105 Z w g\u00f3r\u0119, tak\u017ce z\u0142\u0105 skal\u0119 i orientacj\u0119. Zbyt ci\u0119\u017cki plik otwiera si\u0119 d\u0142ugo, wi\u0119c klient uznaje, \u017ce AR nie dzia\u0142a.<\/p>\n<h2>Jak to naprawi\u0107?<\/h2>\n<table>\n<thead>\n<tr>\n<th>Sprawdzenie<\/th>\n<th>Poprawny stan<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Plik do AR na iPhonie<\/td>\n<td>Osobny plik .usdz albo w\u0142\u0105czone generowanie USDZ w model-viewer<\/td>\n<\/tr>\n<tr>\n<td>Typ MIME<\/td>\n<td>model\/vnd.usdz+zip dla plik\u00f3w .usdz<\/td>\n<\/tr>\n<tr>\n<td>Link r\u0119czny<\/td>\n<td>rel=\"ar\" i dok\u0142adnie jeden element img lub picture w \u015brodku<\/td>\n<\/tr>\n<tr>\n<td>model-viewer<\/td>\n<td>Atrybut ar, tryb quick-look w ar-modes i ios-src z adresem pliku USDZ<\/td>\n<\/tr>\n<tr>\n<td>Skala i orientacja<\/td>\n<td>Metry, o\u015b Y w g\u00f3r\u0119, punkt zero na poziomie pod\u0142o\u017ca<\/td>\n<\/tr>\n<tr>\n<td>Test<\/td>\n<td>Prawdziwy iPhone, Safari i \u015bcie\u017cka z reklamy<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Typ MIME ustawia si\u0119 w konfiguracji serwera, a przy CDN w jego ustawieniach. Na serwerze Apache wystarcz\u0105 dwie linie w pliku .htaccess lub konfiguracji serwera (druga ustawia typ dla plik\u00f3w GLB):<\/p>\n<pre><code>AddType model\/vnd.usdz+zip .usdz\nAddType model\/gltf-binary .glb<\/code><\/pre>\n<p>Po zmianie sprawd\u017a w narz\u0119dziach przegl\u0105darki albo poleceniem curl -I, jaki nag\u0142\u00f3wek Content-Type zwraca adres pliku. Najprostszy przycisk AR, kt\u00f3ry sam dobiera tryb do urz\u0105dzenia, daje komponent model-viewer:<\/p>\n<pre><code>&lt;model-viewer src=\"altana.glb\" ios-src=\"altana.usdz\" ar\n  ar-modes=\"webxr scene-viewer quick-look\"\n  poster=\"altana.webp\" alt=\"Altana ogrodowa, model 3D\"&gt;&lt;\/model-viewer&gt;<\/code><\/pre>\n<div class=\"csb-note\">\n<p>AR na iPhonie testuj zawsze na prawdziwym urz\u0105dzeniu. Narz\u0119dzia na komputerze nie poka\u017c\u0105, czy AR Quick Look faktycznie si\u0119 otwiera, a r\u00f3\u017cnice w materia\u0142ach i skali wida\u0107 dopiero w AR.<\/p>\n<\/div>\n<h2>Co jeszcze sprawdzi\u0107<\/h2>\n<p>Po naprawie sprawd\u017a te\u017c Androida, bo tam dzia\u0142a inny mechanizm (Scene Viewer lub WebXR) z innymi wymaganiami, oraz wag\u0119 plik\u00f3w: ci\u0119\u017cki USDZ otwiera si\u0119 d\u0142ugo, a klient mo\u017ce uzna\u0107, \u017ce przycisk nie dzia\u0142a. Jak odchudzi\u0107 model, opisujemy we wpisie <a href=\"\/blog\/plik-glb-za-duzy-strona-sie-zacina\/\">za du\u017cy plik GLB<\/a>, a osadzenie modelu w karcie produktu we wpisie <a href=\"\/blog\/jak-dodac-model-3d-do-sklepu-woocommerce\/\">jak doda\u0107 model 3D do sklepu WooCommerce<\/a>. Pliki GLB i USDZ, przycisk AR i osadzenie na stronie lub w sklepie przygotowujemy w ramach us\u0142ugi <a href=\"https:\/\/codescriptum.pl\/wizualizacje-3d-produktu\/\">wizualizacje 3D produktu<\/a>.<\/p>\n<p>Ten problem jest jednym z naszej listy <a href=\"\/blog\/30-problemow-z-modelem-3d-i-ar-na-stronie\/\">30 problem\u00f3w z modelem 3D i AR na stronie<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Model 3D nie dzia\u0142a w AR na iPhonie najcz\u0119\u015bciej dlatego, \u017ce strona podaje tylko plik GLB, a AR Quick Look, czyli systemowy podgl\u0105d AR w iOS, przyjmuje pliki .usdz i\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[102],"tags":[],"class_list":["post-90189","post","type-post","status-publish","format-standard","hentry","category-konfiguratory-3d"],"_links":{"self":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts\/90189","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/comments?post=90189"}],"version-history":[{"count":0,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts\/90189\/revisions"}],"wp:attachment":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/media?parent=90189"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/categories?post=90189"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/tags?post=90189"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}