Risoluzione dei problemi relativi al softphone 3CX

Introduzione

Poiché i PC con sistema operativo Microsoft Windows possono presentare versioni di Windows o cronologie di aggiornamento diverse, in alcuni rari casi potrebbe essere necessario adottare alcune misure per ripristinare la funzionalità del softphone 3CX.

Il presente documento illustra alcuni dei problemi più comuni e le relative soluzioni.

Problemi su Windows

Il softphone si avvia ma rimane attivo in background

Se il softphone 3CX si avvia correttamente ma non viene visualizzato automaticamente sul desktop, procedere come segue:

  • Come primo passo, accedere a:

%localappdata%\Packages\3CXDMCC.3CX_97f1hnz6y6tba\LocalCache\Local\3CXSoftphone

OR

%localappdata%\Packages\3CXDMCC.3CX_bhm4yemhnd70e\LocalCache\Local\3CXSoftphone

OR  

%localappdata%\Packages\3CXDMCC.3CXBeta_bhm4yemhnd70e\LocalCache\Local\3CXSoftphone

  • e aprire il file .log.
  • Controllare nel file di log la presenza delle righe riportate di seguito; si noti che è necessario cercare la stringa relativa alla versione corrente del softphone, ad esempio "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

Se viene visualizzata questa eccezione, eseguire le seguenti azioni:

  • Cliccare su Start > Esegui, digitare optionalfeatures e premere OK
  • Selezionare Funzionalità multimediali
  • Espandere l’elenco e assicurarsi che sia selezionato anche Windows Media Player Legacy (App)
  • Cliccare sul pulsante OK
  • Al termine del processo, riavviare il PC.
  • Se i passaggi precedenti non funzionano e si continua a ricevere lo stesso errore, aprire PowerShell come amministratore ed eseguire il seguente comando:

                

Get-WindowsCapability -online | Where-Object -Property name -like "*media*" | Add-WindowsCapability -Online

  • Riavviare il PC.

Il softphone si avvia e si chiude immediatamente

Se il softphone sembra avviarsi normalmente, ma poi si chiude immediatamente, segui i passaggi riportati di seguito per risolvere il problema:

  • Come primo passo, controlla il Visualizzatore eventi:
  • Espandi Applicazioni e registri di servizio > Microsoft > Windows > AppxDeploymentServer > Microsoft-Windows-AppxDeploymentServer/Operational
  • Verifica se è presente una voce simile a:

        

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

Puoi confermare ulteriormente che si tratti proprio del problema da risolvere seguendo i passaggi riportati di seguito:

  • Verifica che l'avvio del softphone come amministratore funzioni correttamente;
  • Sono specificatamente le sessioni utente standard a non funzionare.
  • Prendi nota della versione del Singleton di WindowsAppRuntime; esegui il seguente comando in PowerShell:

Get-AppxPackage -Name "*WinAppRuntime.Singleton*" | Select-Object Name, Version, PackageFullName

  • Confrontala con la tabella sottostante, cerca su Google “Windows App SDK + versione” e scarica il pacchetto ridistribuibile (ZIP) da Microsoft:

Versione del Singleton

Versione di Windows App Runtime

7000.xxx.xxxx.x

Windows App SDK 1.7

8000.xxx.xxxx.x

Windows App SDK 1.8

  • Estrarre il file ZIP e andare alla cartella:
  • /{ExtractedFolder}/MSIX/win10-x64
  • Eseguire i due passaggi indicati di seguito:
  • Come amministratore, copiare il file .msix di Singleton nella tua cartella “Download” personale, quindi
  • Eseguire il seguente comando in PowerShell con diritti di amministratore:

Per 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"

Per 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"

  • Una volta terminato, effettuare nuovamente l’accesso a Windows come utente che presenta il problema di avvio del softphone e, senza essere in modalità amministratore, eseguire il seguente comando in PowerShell:

Add-AppxPackage -RegisterByFamilyName -MainPackage "MicrosoftCorporationII.WinAppRuntime.Singleton_8wekyb3d8bbwe" -Verbose

  • Chiudere e riavviare il softphone 3CX con l'account dell'utente interessato per verificare che ora si avvii normalmente.

Per saperne di pù

Ultimo aggiornamento
Questo documento è stato aggiornato il 29 luglio 2026
https://www.3cx.it/doc/troubleshoot-softphone/