Skip to content

Commit

Permalink
Update README.md (#42)
Browse files Browse the repository at this point in the history
* Update README.md

Redirecting logging instructions to PlayFabParty readme

Adding more clarity to the WSL limitation message in response to a customer question
  • Loading branch information
rachelwu1 authored Apr 18, 2024
1 parent 1cbb8e3 commit e3528e8
Showing 1 changed file with 2 additions and 32 deletions.
34 changes: 2 additions & 32 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,41 +108,11 @@ https://www.nuget.org/packages/Microsoft.PlayFab.PlayFabParty.Cpp.Windows/
It is located at the root of the NuGet package content.

## Logging
The underlying Party C++ library includes logging capabilities with a configurable verbosity level. Logging configuration is defined in `PlayFabPartyLogger.json` file which can be deployed as an asset along with the application. An example of configuration file:

```json
{
"enabled": false,
"bufferSize": 16384,
"maxNumberOfItemsInBatch": 100,
"maxBatchWaitTimeInSeconds": 1,
"readBufferWaitTimeInMilliseconds": 1,
"logFolder": "/platform-specific-path/",
"logLevel": "VERBOSE",
"xrnLogEnabled": false,
"consoleEnabled": false,
"maxLogFileSizeInMegabytes": 0
}
```

When this file is detected by the application in runtime it will use it to enable logging as configured. The following verbosity levels are currently supported:
1. `VERBOSE` - everything
2. `INFO` - less than everything, only important messages and errors
3. `ERROR` - only errors

The logging is disabled by default, but can be enabled with "enabled" property set to `true`.

Instructions to enable logging for specific platform.
Platform|Where to put PlayFabPartyLogger.json (permission needed)|`logFolder` value|How to view logs
|-|-|-|-|
Linux|Create a folder "/home/{user}/PlayFabParty/" where {user} is the current user logged in | /home/{user}/PlayFabParty/log/ | Navigate to the `/home/{user}/PlayFabParty/log/` directory and open logs directly
iOS|Inside the application folder (Set UIFileSharingEnabled to true in the Info.plist of the app)|/app_sandbox_storage/Documents/|Copy logs from `logFolder` to PC
Android|Create a folder "\sdcard\PlayFabParty\config" (External storage folder requires READ_EXTERNAL_STORAGE permission)|/sdcard/PlayFabParty/log/|Copy logs from `logFolder` to PC and open in NotePad++
macOS|~/Documents (Set UIFileSharingEnabled to true in the Info.plist of the app)|~/Documents|Open logs directly in `logFolder`
The underlying Party C++ library includes logging capabilities with a configurable verbosity level. Logging instructions can be found in the [PlayFabParty ReadMe](https://github.com/PlayFab/PlayFabParty#logging)

## WSL Compatibility

PlayFab Party for Linux is not intended to run on the Windows Subsystem for Linux (WSL). Please run on a dedicated Linux machine to take advantage of all Party features.
PlayFab Party for Linux is not intended to run on the Windows Subsystem for Linux (WSL) as it does not have built in support for system sound. As a result, chat features will not function properly. Please run on a dedicated Linux machine to take advantage of all Party features.

## Troubleshooting

Expand Down

0 comments on commit e3528e8

Please sign in to comment.