update docs

AlphaBs · AlphaBs · commit 5086a16e7663 · 2021-02-15T22:30:53.000+09:00
diff --git a/MojangAPI/MojangAuth.cs b/MojangAPI/MojangAuth.cs
@@ -157,6 +157,16 @@ public async Task<MojangAuthResponse> TryAutoLogin()
             return res;
         }
 
+        public async Task<MojangAuthResponse> TryAutoLogin(Session session)
+        {
+            MojangAuthResponse res = await Validate(session);
+
+            if (!res.IsSuccess)
+                res = await Refresh(session);
+
+            return res;
+        }
+
         public Task<MojangAuthResponse> Refresh()
         {
             Session? cachedSession = cacheManager?.ReadCache();
diff --git a/docs/MojangAPI.md b/docs/MojangAPI.md
@@ -21,6 +21,10 @@ else
 }
 ```
 
+### How to get `AccessToken` or `UUID`?
+
+You can get these token by [Mojang Authentication](./MojangAuth.md) or [Microsoft Xbox Authentication](./XboxAuthentication.md)
+
 ### Methods
 
 #### GetUUID
@@ -96,12 +100,14 @@ PlayerProfile profile = await mojang.ChangeName("accessToken", "newName");
 #### ChangeSkin
 
 ```csharp
+// SkinType.Steve or SkinType.Alex
 MojangAPIResponse response = await mojang.ChangeSkin("uuid", "accessToken", SkinType.Steve, "skinUrl");
 ```
 
 #### UploadSkin
 
 ```csharp
+// SkinType.Steve or SkinType.Alex
 MojangAPIResponse response = await mojang.UploadSkin("accessToken", SkinType.Steve, "skin_png_file_path");
 ```
 ```csharp
diff --git a/docs/MojangAuth.md b/docs/MojangAuth.md
@@ -1,3 +1,13 @@
+## What is Minecraft `Session`?
+
+`Session` is an authentication information, that contains `AccessToken`, `UUID` and `Username`.  
+`AccessToken` is a temporary token issued after login. ([wiki](https://en.wikipedia.org/wiki/Access_token)).  
+`UUID` is a unique value given to each player. This value cannot be changed. ([wiki](https://en.wikipedia.org/wiki/Universally_unique_identifier))  
+`Username` is player name. This value can be changed by user.  
+
+Some APIs (changing skin or name, etc) require you `Session`, and you can get this by login.  
+`MojangAuth` class provides methods to login.
+
 ## class MojangAuth
 
 Most methods return `MojangAuthResponse` or class inherited from `MojangAuthResponse`.  
@@ -7,6 +17,9 @@ If `IsSuccess` is false, `Result`, `Error`, and `ErrorMessage` property tell you
 
 `MojangAuth` has its own session caching manager. You don't have to type mojang email and password everytime when you login. Login once using your mojang email and password, and `MojangAuth` will save your session information into json file(not contain your raw password, it contains only tokens). Next time when you login just call `TryAutoLogin`. it authenticate you using cached session without typing mojang email and password.
 
+There are two ways to login. One is `Yggdrasil Mojang Authentication` which is described below, and the other is `Microsoft Xbox Authentication` which is new way to login.  
+[Microsoft Xbox Authentication](./XboxAuthentication.md)
+
 Example: 
 
 ```csharp
diff --git a/docs/XboxAuthentication.md b/docs/XboxAuthentication.md
@@ -1 +1,30 @@
-writing
+## Microsoft Xbox Authentication
+
+[wiki.vg](https://wiki.vg/Microsoft_Authentication_Scheme)
+
+[MojangAuth](./MojangAuth.md) provides methods to authenticate with Minecraft using Xbox game token.  
+But it does not provide `Microsoft OAuth Flow` and `Xbox Authentication`.  
+Use another library like [XboxAuthNet](https://github.com/AlphaBs/XboxAuthNet) or [xbox-webapi-csharp](https://github.com/OpenXbox/xbox-webapi-csharp).
+
+You can acquire `XSTSToken` and `ush`(User Hash) through `Microsoft OAuth` and `Xbox Authentication`,.  
+And then call `RequestSessionWithXbox` method  with these values.
+
+Example: 
+```csharp
+HttpClient httpClient = new HttpClient();
+MojangAuth auth = new MojangAuth(httpClient);
+
+MojangAuthResponse res = await auth.RequestSessionWithXbox("ush", "XSTSToken");
+if (res.IsSuccess)
+{
+    // res.Session.Username
+    // res.Session.AccessToken
+    // res.Session.UUID
+}
+else
+{
+    // res.Result
+    // res.Error
+    // res.ErrorMessage
+}
+```
