Rozwiązywanie problemów z 3CX Windows Softphone
Wprowadzenie
Ponieważ komputery PC z systemem Microsoft Windows mogą różnić się wersjami systemu lub historią aktualizacji, w rzadkich przypadkach konieczne może być podjęcie dodatkowych kroków w celu przywrócenia funkcjonalności aplikacji 3CX Softphone.
Niniejszy dokument opisuje niektóre z najczęstszych problemów tego typu oraz sposoby ich rozwiązywania.
Problemy z systemem Windows
Softphone uruchamia się, ale pozostaje w tle
Jeśli Twój 3CX Softphone uruchamia się pomyślnie, ale nie pojawia się automatycznie na pulpicie, wykonaj następujące kroki:
- W pierwszej kolejności przejdź do katalogu:
%localappdata%\Packages\3CXDMCC.3CX_97f1hnz6y6tba\LocalCache\Local\3CXSoftphone
LUB
%localappdata%\Packages\3CXDMCC.3CX_bhm4yemhnd70e\LocalCache\Local\3CXSoftphone
LUB
%localappdata%\Packages\3CXDMCC.3CXBeta_bhm4yemhnd70e\LocalCache\Local\3CXSoftphone
- i otwórz plik .log.
- Sprawdź plik logu pod kątem wierszy pokazanych poniżej (pamiętaj, że musisz szukać ciągu znaków odpowiadającego Twojej aktualnej wersji Softphonu, np. „release-V5.6”):
[FTL|2|_3CXSoftphone.App] UNHANDLED EXCEPTION
System.IO.FileNotFoundException: The specified module could not be found. (0x8007007E)
at System.Runtime.InteropServices.Marshal.ThrowExceptionForHR(Int32 errorCode)
at WinRT.ActivationFactory.Get(String typeName)
at Windows.Media.Playback.MediaPlayer.get__objRef_global__Windows_Media_Playback_MediaPlayer()
at Windows.Media.Playback.MediaPlayer..ctor()
at _3CXSoftphone.Telephony.Ringtone.RingtonePlayerImpl..ctor(ILoggerFactory loggerFactory, IAudioDeviceSource audioDeviceSource, ISettingsService settingsService) in C:\_\workspace\3CXPhone\softphone\release-V5.6\app\3CXSoftphone\Telephony\Ringtone\RingtonePlayerImpl.cs:line 31
Jeśli powyższy wyjątek (exception) jest widoczny, wykonaj następujące czynności:
- Kliknij Start > Run (Uruchom), wpisz optionalfeatures i naciśnij OK.
- Wybierz „Media Features” (Funkcje multimedialne).
- Rozwiń listę i upewnij się, że opcja „Windows Media Player Legacy (App)” jest również zaznaczona.
- Kliknij przycisk OK.
- Po zakończeniu procesu uruchom ponownie komputer.
- W przypadku, gdy powyższe kroki nie pomogą i nadal otrzymujesz ten sam błąd, otwórz PowerShell jako administrator i uruchom następujące polecenie:
Get-WindowsCapability -online | Where-Object -Property name -like "*media*" | Add-WindowsCapability -Online
- Uruchom ponownie komputer.
Softphone uruchamia się i natychmiast wyłącza
Jeśli Twój Softphone wydaje się uruchamiać normalnie, ale potem natychmiast się zamyka, wykonaj poniższe kroki, aby rozwiązać problem:
- W pierwszej kolejności sprawdź Podgląd Zdarzeń (Event Viewer):
- Rozwiń „Applications and Service Logs” > „Microsoft” > „Windows” > „AppxDeploymentServer” > „Microsoft-Windows-AppxDeploymentServer/Operational”.
- Sprawdź, czy widzisz wpis podobny do poniższego:
MicrosoftCorporationII.WinAppRuntime.Singleton_8000.921.1539.0_x64__8wekyb3d8bbwe :
C:\Program Files\WindowsApps\MicrosoftCorporationII.WinAppRuntime.Singleton_8000.921.1539.0_x64__8wekyb3d8bbwe\microsoft.system.package.metadata\S-1-5-21-...-MergedResources-*.pri :
No user-specific merged files found
Możesz dodatkowo potwierdzić, że jest to dokładnie ten problem, wykonując następujące czynności:
- Sprawdź, czy uruchomienie Softphonu jako administrator działa poprawnie.
- Problem występuje konkretnie podczas sesji standardowych użytkowników.
- Zanotuj wersję „WindowsAppRuntime Singleton”; uruchom następujące polecenie w PowerShell:
Get-AppxPackage -Name "*WinAppRuntime.Singleton*" | Select-Object Name, Version, PackageFullName
- Dopasuj wynik do poniższej tabeli, wyszukaj w Google frazę „Windows App SDK + wersja” i pobierz pakiet Redistributable (ZIP) ze strony Microsoft:
Wersja Singleton | Wersja Windows App Runtime |
7000.xxx.xxxx.x | Windows App SDK 1.7 |
8000.xxx.xxxx.x | Windows App SDK 1.8 |
- Wypakuj plik ZIP i przejdź do katalogu:
- /{ExtractedFolder}/MSIX/win10-x64
- Wykonaj dwa poniższe kroki:
- Jako administrator skopiuj plik Singleton .msix do swojego osobistego folderu Pobrane (Downloads).
- Uruchom poniższe polecenie w PowerShell z uprawnieniami administratora:
Dla Windows App SDK 1.7:
$path = "$env:USERPROFILE\Downloads\Microsoft.WindowsAppRuntime.Singleton.1.7.msix"
Add-AppxProvisionedPackage -Online -PackagePath $path -SkipLicense -LogPath "C:\Temp\Singleton_Provision.log"
Dla Windows App SDK 1.8:
$path = "$env:USERPROFILE\Downloads\Microsoft.WindowsAppRuntime.Singleton.1.8.msix"
Add-AppxProvisionedPackage -Online -PackagePath $path -SkipLicense -LogPath "C:\Temp\Singleton_Provision.log"
- Po zakończeniu zaloguj się ponownie do systemu Windows jako użytkownik, u którego występuje problem z uruchamianiem Softphonu, i nie będąc w trybie administratora, uruchom następujące polecenie w PowerShell:
Add-AppxPackage -RegisterByFamilyName -MainPackage "MicrosoftCorporationII.WinAppRuntime.Singleton_8wekyb3d8bbwe" -Verbose
- Zamknij i ponownie uruchom 3CX Softphone na koncie dotkniętego użytkownika, aby potwierdzić, że teraz uruchamia się normalnie.
Zobacz również
- Aplikacja 3CX Windows Softphone
- Wdrażanie aplikacji 3CX Softphone poprzez zasady grup AD (GPO)
- Automatyczne wdrażanie 3CX Softphone przy użyciu usługi Intune
- Jak zainstalować wieloliniowy interfejs TAPI
Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 28 lipca 2026 r.
https://www.3cx.pl/docs/troubleshoot-softphone/
