> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 알림 이미지가 표시되지 않음
> 알림 이미지가 표시되지 않습니다.
이미지가 포함된 푸시 알림을 보낼 때 OneSignal SDK는 [OSNotification Payload](./osnotification-payload)에서 외부 이미지 URL을 가져와서 알림 내에 표시하려고 시도합니다. 이 프로세스 중에 앱이 닫혀 있는지 여부는 중요하지 않습니다. SDK는 이미지가 다운로드될 때까지 대기하지만 약 25초(Apple에서 강제 적용) 이상 걸리면 이미지 없이 알림이 표시됩니다. OneSignal의 SDK는 다운로드에 실패하면 이미지를 다시 가져오려고 시도하지 않습니다.
이 가이드는 이미지가 표시되지 않는 가장 일반적인 이유와 해결 방법을 다룹니다. 이미지 사양에 대한 자세한 내용은 [Images & Rich Media](./rich-media)를 참조하세요.
## 이미지 구성
이미지가 올바르게 구성되었는지 확인하려면 먼저 다음 항목을 확인하세요.
### 이미지 크기
이미지 크기는 5MB 미만이어야 합니다. 이미지가 작을수록 더 빠르게 다운로드됩니다. 자세한 내용은 [Images & Rich Media](./rich-media)를 참조하세요.
### 이미지 URL
* 이미지 URL은 이미지 리소스에 대한 직접 링크가 필요합니다. 리디렉션이나 이미지를 표시하지만 실제 이미지 리소스가 아닌 페이지에 대한 링크는 사용할 수 없습니다.
* 일반적으로 이미지 URL은 `https://`로 시작하고 `.png` 또는 `.jpg`와 같은 파일 확장자로 끝나야 합니다.
예시:
* 작동하지 않음: `https://pixabay.com/en/architecture-travel-sky-building-3095716/`
* 이미지를 마우스 오른쪽 버튼으로 클릭하고 새 탭에서 열면 작동함: `https://cdn.pixabay.com/photo/2018/01/21/01/46/architecture-3095716_960_720.jpg`
### 이미지 호스트
OneSignal에 이미지를 업로드하면 약 33일 동안 서버에 호스팅됩니다. 더 오래 이미지가 필요한 경우 템플릿을 사용하거나 자체 서버에 이미지를 저장하고 템플릿에서 리소스 URL을 직접 참조할 수 있습니다.
이미지를 자체 호스팅하는 경우 서버가 다운로드 양을 처리할 수 있는지 확인해야 합니다. 알림을 받는 각 장치는 이미지를 다운로드해야 합니다. 장치가 이미지를 포함한 모든 알림 리소스를 다운로드하는 데 약 30초가 주어집니다. 시간이 더 오래 걸리면 해당 장치에 표시되지 않습니다.
***
## 장치 구성
장치의 인터넷 연결을 확인하세요. 불안정한 네트워크 연결로 인해 이미지가 표시되지 않을 수 있습니다.
* 다른 WiFi 네트워크에서 테스트하세요.
* 다른 셀룰러 네트워크에서 테스트하세요.
* 다른 장치에서 테스트하세요.
***
## 플랫폼 구성
이미지를 받지 못하는 플랫폼에 따라 아래 섹션을 확인하세요.
### Web push 이미지
* **Windows 및 Android에서 Chrome만 푸시 알림의 큰 이미지를 지원합니다**.
* macOS용 Chrome은 큰 이미지를 지원하지 않습니다.
* Firefox, Safari 및 Edge는 큰 이미지를 지원하지 않습니다.
* Android에서 알림을 받으면 알림을 탭하여 확장해야 이미지를 볼 수 있습니다.
모바일 브라우저 앱에 읽지 않은 푸시 알림이 많거나 열려 있는 탭이 많으면 알림이 표시되지 않을 수 있습니다.
### Android push 이미지
Android 알림 센터에서 알림을 받으면 알림을 확장해야 이미지를 볼 수 있습니다.
Android는 푸시 알림에서 이미지를 받기 위한 추가 구성이 필요하지 않습니다.
### iOS push 이미지
iOS 알림은 Notification Service Extension이 올바르게 설정되어야 합니다. Notification Service Extension 설정은 사용 중인 SDK 버전에 대한 [Mobile SDK 설정](./mobile-sdk-setup) 가이드에서 다룹니다.
이미지 URL이 HTTP이고 HTTP URL을 사용하여 직접 호스팅하려는 경우 Xcode .plist에서 `NSAppTransportSecurity`를 `NSAllowsArbitraryLoads`로 설정해야 합니다.
`NSAllowsArbitraryLoads`가 활성화되어 있으면 보안 취약점이 생성될 수 있으므로 App Store에 앱을 출시할 때 Apple이 앱을 거부할 수 있습니다. 자세한 내용은 Apple의 [Security Overview](https://www.apple.com/business/resources/docs/iOS_Security_Overview.pdf)를 참조하세요.
***
## 기술적 문제 해결
위의 항목을 확인했지만 이미지가 여전히 표시되지 않으면 SDK의 [`setLogLevel` 메서드](./mobile-sdk-reference#setloglevel)를 `VERBOSE` 로깅과 함께 사용하여 이미지 다운로드와 관련된 특정 오류를 확인하세요.
로그 생성에 대한 자세한 가이드는 [Capturing a Debug Log](./capturing-a-debug-log) 가이드를 참조하세요.
일반적인 오류는 다음과 같습니다:
* `Could not download image!`
* `Encountered an error while attempting to download file with URL:`
* `OneSignal encountered an exception while downloading file`
### iOS Notification Service Extension 문제 해결
iOS에서 이미지가 표시되지 않으면 [Troubleshooting the iOS Notification Service Extension](./service-extensions#troubleshooting-the-ios-notification-service-extension) 가이드를 따르세요.
이 가이드는 Notification Service Extension 설정을 검토하고 문제를 식별하는 데 도움이 됩니다.
***