Share via


Acceleration, App, Compass, Connection และ Location ใน Power Apps

ใช้กับ: แอปพื้นที่ทำงาน แอปแบบจำลอง

ส่งกลับข้อมูลเกี่ยวกับสภาพแวดล้อมของแอป เช่น ตำแหน่งที่ผู้ใช้อยู่ในโลก และหน้าจอใดที่แสดงขึ้น

คำอธิบายและไวยากรณ์

สัญญาณคือค่าที่สามารถเปลี่ยนแปลงได้ตลอดเวลา โดยไม่ขึ้นกับว่าผู้ใช้อาจโต้ตอบกับแอปอย่างไร สูตรที่ยึดตามสัญญาณจะคำนวณใหม่โดยอัตโนมัติเมื่อค่าเหล่านี้เปลี่ยนไป

สัญญาณมักส่งกลับ เรกคอร์ด ของข้อมูล คุณสามารถใช้ และจัดเก็บข้อมูลนี้เป็นเรกคอร์ด หรือคุณสามารถแยกคุณสมบัติแต่ละรายการโดยใช้ .ตัวดำเนินการ

หมายเหตุ

ฟังก์ชัน การเร่ง และ เข็มทิศ ส่งกลับค่าที่แม่นยำในตัวเล่นดั้งเดิมดัง เช่น บน iOS หรือ Android แต่ฟังก์ชันเหล่านั้นส่งกลับค่าศูนย์ขณะที่คุณสร้างหรือปรับเปลี่ยนแอปในเบราว์เซอร์

การเร่ง

สัญญาณ ความเร่ง ส่งกลับความเร่งของอุปกรณ์ในสามมิติซึ่งเทียบกับหน้าจอของอุปกรณ์ ความเร่งวัดเป็นหน่วย g มีค่า 9.81 ม./วินาที2 หรือ 32.2 ฟุต/วินาที2 (ความเร่งที่โลกส่งผลต่อวัตถุที่พื้นผิวเนื่องจากแรงโน้มถ่วง)

คุณสมบัติ คำอธิบาย
Acceleration.X ขวาและซ้าย ขวาเป็นจำนวนบวก
Acceleration.Y ไปข้างหน้าและย้อนกลับ ไปข้างหน้าเป็นจำนวนบวก
Acceleration.Z ขึ้นและลง ขึ้นเป็นจำนวนบวก

แอป

ในบรรดาคุณสมบัติต่าง ๆ วัตถุ แอป มีสัญญาณที่บ่งบอกว่าหน้าจอใดกำลังแสดงอยู่

คุณสมบัติ คำอธิบาย
App..ActiveScreen หน้าจอที่แสดงอยู่ ส่งกลับวัตถุหน้าจอ ซึ่งคุณสามารถใช้เพื่ออ้างอิงคุณสมบัติของหน้าจอ หรือเปรียบเทียบกับหน้าจออื่นเพื่อกำหนดว่าจะแสดงหน้าจอใด คุณสามารถใช้ใช้ฟังก์ชัน Back หรือ Navigate เพื่อเปลี่ยนหน้าจอที่กำลังแสดง

ข้อมูลเพิ่มเติม: เอกสารประกอบ วัตถุ App

Compass

สัญญาณ เข็มทิศ ส่งกลับทิศทางของเข็มทิศที่ชี้ไปทางด้านบนของหน้าจอ ทิศทางจะขึ้นอยู่กับแม่เหล็กทางทิศเหนือ

คุณสมบัติ คำอธิบาย
Compass.Heading ทิศทางเป็นองศา ส่งกลับเป็นตัวเลข 0 ถึง 360 โดย 0 คือทิศเหนือ

การเชื่อมต่อ

สัญญาณ การเชื่อมต่อ ส่งกลับข้อมูลเกี่ยวกับการเชื่อมต่อเครือข่าย เมื่อใช้การเชื่อมต่อแบบคิดค่าบริการตามปริมาณข้อมูล คุณอาจต้องการจำกัดปริมาณข้อมูลที่คุณส่งหรือรับบนเครือข่าย หรือถ้าแอปของคุณเปิดใช้งานแบบออฟไลน์ คุณอาจต้องการแสดงข้อมูลที่แตกต่างกันโดยขึ้นอยู่กับสถานะการซิงค์ปัจจุบัน

คุณสมบัติ รายละเอียด
Connection.Connected ส่งกลับค่าบูลีน true หรือ false ที่ระบุว่า อุปกรณ์เชื่อมต่อกับเครือข่ายหรือไม่
Connection.Metered ส่งกลับค่าบูลีน true หรือ false ที่ระบุว่า การเชื่อมต่อคิดค่าบริการตามปริมาณข้อมูลหรือไม่
Connection.Sync ส่งคืน enum ที่ชื่อ ConnectionSync ซึ่งเก็บสถานะการซิงโครไนซ์ปัจจุบันสำหรับแอปที่เปิดใช้งานสำหรับออฟไลน์

ด้านล่างนี้คือค่า enum ที่มีสำหรับ Connection.Sync

ค่า Enum รายละเอียด
Connected อุปกรณ์ของคุณเชื่อมต่อกับเครือข่าย และแอปของคุณพร้อมที่จะทำงานแบบออฟไลน์
ConnectedWithWarning อุปกรณ์ของคุณเชื่อมต่ออยู่โดยมีคำเตือน
ConnectedPendingUpsync ข้อมูลบางอย่างบนอุปกรณ์ของคุณต้องซิงโครไนซ์กับบริการ
ConnectedError มีข้อผิดพลาดในการพยายามซิงโครไนซ์ครั้งล่าสุด
ConnectedRefresh แอปของคุณกำลังซิงโครไนซ์ข้อมูลกับบริการ
NotConnected อุปกรณ์ของคุณไม่ได้เชื่อมต่อกับบริการ
NotConnectedWithWarning คำเตือนการซิงโครไนซ์ครั้งล่าสุด
NotConnectedPendingUpsync มีการอัปเดตบนอุปกรณ์ของคุณที่รอการซิงโครไนซ์
NotConnectedSyncError ข้อผิดพลาดการซิงโครไนซ์ครั้งล่าสุด

ตำแหน่ง

สัญญาณ ตำแหน่งที่ตั้ง ส่งกลับตำแหน่งที่ตั้งของอุปกรณ์ตามระบบกำหนดตำแหน่งตามพื้นโลก (GPS) และข้อมูลอุปกรณ์อื่น ๆ เช่น การสื่อสารระหว่างมือถือและหอสัญญาณ และที่อยู่ IP

เมื่อผู้ใช้เข้าถึงข้อมูลตำแหน่งที่ตั้งเป็นครั้งแแรก อุปกรณ์อาจพร้อมท์ให้ผู้ใช้อนุญาตการเข้าถึงข้อมูลนี้

เมื่อมีการเปลี่ยนแปลงตำแหน่งที่ตั้ง การอ้างอิงตำแหน่งที่ตั้งจะคำนวณใหม่อย่างต่อเนื่อง ซึ่งจะใช้พลังงานจากแบตเตอรี่ของอุปกรณ์ เมื่อต้องการประหยัดแบตเตอรี่ คุณสามารถใช้ฟังก์ชัน Enable และ Disable เพื่อเปิดหรือปิดการอัปเดตตำแหน่งที่ตั้ง ตำแหน่งที่ตั้งจะปิดโดยอัตโนมัติถ้าหน้าจอที่แสดงไม่ได้ขึ้นอยู่กับข้อมูลตำแหน่งที่ตั้ง

คุณสมบัติ คำอธิบาย
Location.Altitude ส่งกลับตัวเลขที่ระบุความสูงเหนือระดับน้ำทะเล ซึ่งวัดในหน่วยเมตร
Location.Latitude ส่งกลับตัวเลขจาก -90 ถึง 90 ที่ระบุละติจูด ตามที่วัดในหน่วยองศาจากเส้นศูนย์สูตร ตัวเลขค่าบวกระบุตำแหน่งที่ตั้งซึ่งอยู่เหนือเส้นศูนย์สูตร
Location.Longitude ส่งกลับตัวเลขจาก -180 ถึง 180 ที่ระบุลองจิจูด ตามที่วัดในหน่วยองศาจากกรีนิช ประเทศอังกฤษ ตัวเลขค่าบวกระบุตำแหน่งที่ตั้งซึ่งอยู่ทางตะวันออกของเมืองกรีนิช

ตัวอย่าง

ในสนามเบสบอล พิทเชอร์ขว้างโทรศัพท์จากจุดขว้างของพิทเชอร์ ไปยังแคชเชอร์ที่โฮมเพลท โทรศัพท์ลอยขนานไปกับพื้น หันด้านบนไปทางแคชเชอร์ และพิชเชอร์ไม่ได้ปาลูกหมุน ณ จุดนี้ โทรศัพท์มีบริการเครือข่ายโทรศัพท์ที่คิดค่าบริการ แต่ไม่มี Wi-Fi หน้าจอ PlayBall จะแสดงขึ้น แอปเปิดใช้งานสำหรับออฟไลน์และเชื่อมต่อกับบริการ

สูตร รายละเอียด Result
Location.Latitude ส่งกลับละติจูดของตำแหน่งที่ตั้งปัจจุบัน สนามอยู่ที่พิกัดแผนที่ 47.591 เหนือ 122.333 ตะวันตก 47.591

ละติจูดจะเปลี่ยนแปลงตลอดเวลาที่บอลลอยอยู่ระหว่างพิชเชอร์กับแคชเชอร์
Location.Longitude ส่งกลับลองจิจูดของตำแหน่งที่ตั้งปัจจุบัน 122.333

ลองจิจูดจะเปลี่ยนแปลงตลอดเวลาที่บอลลอยอยู่ระหว่างพิชเชอร์กับแคชเชอร์
Location ส่งกลับละติจูดและลองจิจูดของตำแหน่งที่ตั้งปัจจุบันเป็นเรกคอร์ดหนึ่ง { ละติจูด: 47.591, ลองจิจูด: 122.333 }
Compass.Heading ส่งกลับทิศทางของเข็มทิศที่ด้านบนของหน้าจอ ที่สนามนี้โฮมเพลทจะอยู่ทางตะวันตกเฉียงใต้จากจุดขว้างของพิทเชอร์ 230.25
Acceleration.X ส่งกลับความเร่งด้านข้างของอุปกรณ์ พิทเชอร์กำลังขว้างโทรศัพท์ตรงไปข้างหน้าตามด้านบนของหน้าจอ ดังนั้นจึงไม่มีความเร่งด้านข้าง 0
Acceleration.Y ส่งกลับความเร่งของอุปกรณ์จากด้านหน้าไปด้านหลัง ในขั้นต้นพิทเชอร์ให้ความเร่งขนาดใหญ่แก่อุปกรณ์ เมื่อขว้างอุปกรณ์ที่เริ่มจาก 0 ถึง 90 ไมล์ต่อชั่วโมง (132 ฟุตต่อวินาที) ในครึ่งวินาที หลังจากที่อุปกรณ์อยู่ในอากาศโดยไม่สนใจแรงเสียดทานอากาศ อุปกรณ์จะไม่เร่งเพิ่มขึ้น อุปกรณ์จะชะลอตัวเมื่อแคชเชอร์รับได้ ซึ่งทำให้อุปกรณ์หยุด 8.2 ขณะที่พิทเชอร์ขว้างอุปกรณ์

0 ขณะที่อุปกรณ์อยู่ในอากาศ

-8.2 เมื่อแคชเชอร์รับอุปกรณ์ได้
Acceleration.Z ส่งกลับความเร่งของอุปกรณ์จากด้านบนลงด้านล่าง ขณะอยู่ในอากาศ อุปกรณ์จะสัมผัสกับผลกระทบของแรงโน้มถ่วง 0 ก่อนที่พิทเชอร์จะขว้างอุปกรณ์

1 ขณะที่อุปกรณ์อยู่ในอากาศ

0 หลังจากที่แคชเชอร์รับอุปกรณ์ได้
การเร่ง ส่งกลับความเร่งเป็นเรกคอร์ด { X: 0, Y: 264, Z: 0 } ในขณะที่พิทเชอร์ขว้างอุปกรณ์
Connection.Connected ส่งกลับค่าบูลีนที่ระบุว่า อุปกรณ์เชื่อมต่อกับเครือข่ายหรือไม่ true
Connection.Metered ส่งกลับค่าบูลีนที่ระบุว่า การเชื่อมต่อคิดค่าบริการตามปริมาณข้อมูลหรือไม่ จริง
Connection.Sync ส่งคืนค่า enum ที่ระบุสถานะการซิงค์ปัจจุบัน ConnectionSync.Connected
App..ActiveScreen = PlayBall ส่งกลับค่าบูลีนที่ระบุว่า มีการแสดง PlayBall หรือไม่ true
App..ActiveScreen.Fill ส่งกลับสีพื้นหลังสำหรับหน้าจอที่แสดง Color.Green