Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Player Tracking guide, and GameServer reference. #1569

Merged
merged 1 commit into from
May 19, 2020

Conversation

markmandel
Copy link
Member

What type of PR is this?

Uncomment only one /kind <> line, hit enter to put that in a new line, and remove leading whitespace from that line:

/kind breaking
/kind bug
/kind cleanup
/kind documentation

/kind feature

/kind hotfix

What this PR does / Why we need it:

Includes the guide for player tracking, explaining how the SDK commands can be used for player user journeys.

Included is also updates to the GameServer references.

Also included a small fix in the comments wherein we were still referencing the webhook from the previous design.

Which issue(s) this PR fixes:

Work on #1033

Special notes for your reviewer:
None

@markmandel markmandel added kind/feature New features for Agones kind/documentation Documentation for Agones labels May 18, 2020
@markmandel markmandel added this to the 1.6.0 milestone May 18, 2020
@agones-bot
Copy link
Collaborator

Build Succeeded 👏

Build Id: 456b50ba-8cb2-4841-be9c-bd01f4164b1b

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

To install this version:

  • git fetch https://github.com/GoogleCloudPlatform/agones.git pull/1569/head:pr_1569 && git checkout pr_1569
  • helm install ./install/helm/agones --namespace agones-system --name agones --set agones.image.tag=1.6.0-0ec2b41

# [Stage:Alpha]
# [FeatureFlag:PlayerTracking]
# Players provides the configuration for player tracking features.
players:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since this won't work as-is on a default installation, it might be better to have it commented out by default. Otherwise, someone might try to apply this example to a 1.6 install and it will fail.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

100% agree. Good call.

# [Stage:Alpha]
# [FeatureFlag:PlayerTracking]
# Players provides the configuration for player tracking features.
players:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same here: should fields that only work with defaulted-off feature flags be commented out in the reference examples?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

* Check if a specific player is connected, call [`SDK.Alpha().IsPlayerConnected(playerID)`]({{< ref "/docs/Guides/Client SDKs/_index.md#alpha-isplayerconnected-playerid" >}})
* Retrieve the full list of connected players, call [`SDK.Alpha().GetConnectedPlayers()`]({{< ref "/docs/Guides/Client SDKs/_index.md#alpha-getconnectedplayers" >}})

## Next Step
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Even though there is only one link, I think this should be plural, like on https://0ec2b41-dot-preview-dot-agones-images.appspot.com/site/docs/installation/creating-cluster/gke/


From the SDK, the game server binary can also retrieve the current player capacity
via [`SDK.Alpha().GetPlayerCapacity()`]({{< ref "/docs/Guides/Client SDKs/_index.md#alpha-getplayercapacity" >}}).

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Making a note here, to make sure I make the change:
#1570 (comment)

It might be worth clarifying that this capacity is not enforced as that is not a responsibility of Agones

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@steven-supersolid added notes here regarding both capacity changes, and also connect/disconnect.

Copy link
Collaborator

@steven-supersolid steven-supersolid May 19, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great. This feature is really cool BTW and should enable us to remove some game code!

Includes the guide for player tracking, explaining how the SDK commands
can be used for player user journeys.

Included is also updates to the GameServer references.

Also included a small fix in the comments wherein we were still
referencing the webhook from the previous design.

Work on googleforgames#1033
@markmandel markmandel force-pushed the docs/tracking-page branch from 0ec2b41 to de30928 Compare May 19, 2020 17:05
@google-oss-robot
Copy link

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: markmandel, roberthbailey

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:
  • OWNERS [markmandel,roberthbailey]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@agones-bot
Copy link
Collaborator

Build Failed 😱

Build Id: fa9ba126-7957-427b-bf4e-f5c08443d516

To get permission to view the Cloud Build view, join the agones-discuss Google Group.

@roberthbailey
Copy link
Member

Looks like this is your new test:

--- FAIL: TestFleetAggregatedPlayerStatus (124.40s)
    fleet_test.go:1270: Could not message GameServer: read udp 192.168.10.4:56872->35.203.183.113:7685: i/o timeout

@agones-bot
Copy link
Collaborator

Build Succeeded 👏

Build Id: 4025652c-08ac-48c8-bea9-afbcd6a61297

The following development artifacts have been built, and will exist for the next 30 days:

A preview of the website (the last 30 builds are retained):

To install this version:

  • git fetch https://github.com/GoogleCloudPlatform/agones.git pull/1569/head:pr_1569 && git checkout pr_1569
  • helm install ./install/helm/agones --namespace agones-system --name agones --set agones.image.tag=1.6.0-de30928

@markmandel markmandel merged commit 45fa059 into googleforgames:master May 19, 2020
@markmandel markmandel deleted the docs/tracking-page branch May 19, 2020 17:43
ilkercelikyilmaz pushed a commit to ilkercelikyilmaz/agones that referenced this pull request Oct 23, 2020
Includes the guide for player tracking, explaining how the SDK commands
can be used for player user journeys.

Included is also updates to the GameServer references.

Also included a small fix in the comments wherein we were still
referencing the webhook from the previous design.

Work on googleforgames#1033
ilkercelikyilmaz pushed a commit to ilkercelikyilmaz/agones that referenced this pull request Oct 23, 2020
Includes the guide for player tracking, explaining how the SDK commands
can be used for player user journeys.

Included is also updates to the GameServer references.

Also included a small fix in the comments wherein we were still
referencing the webhook from the previous design.

Work on googleforgames#1033
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved kind/documentation Documentation for Agones kind/feature New features for Agones lgtm size/L
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants