Fix close pip via UI tests

1. Rename tests

2. Fix existing assertions

3. Add documentation for test and assertions

Bug: 174238257
Test: atest WMShellFlickerTests:com.android.wm.shell.flicker.pip
Change-Id: I95da624e6710f2a77dc0b6a62c5647b2d84faeb2